Delen via

Servers - Update

Service:
SQL Database
API-versie:
2025-01-01

Hiermee wordt een server bijgewerkt.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2025-01-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
identity

ResourceIdentity

Serveridentiteit
properties.administratorLogin

string

Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword

string (password)

Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators

ServerExternalAdministrator

De Azure Active Directory-beheerder kan worden gebruikt tijdens servercreatie en voor serverupdates, behalve voor de azureADOnlyAuthentication-eigenschap. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API worden gebruikt.
properties.createMode

ServerCreateMode

Maakmodus voor server, alleen geldige waarden hiervoor zijn Normaal en Herstellen.
properties.federatedClientId

string (uuid)

De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.isIPv6Enabled

ServerNetworkAccessFlag

Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion

MinimalTlsVersion

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId

string

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.retentionDays

integer (int32)

Het aantal dagen dat deze server voorlopig verwijderd blijft.
properties.version

string

De versie van de server.
tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

Server

Azure-operatie succesvol voltooid.
202 Accepted

Aanvraag voor resource-update geaccepteerd.

Kopteksten

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Update a server

Voorbeeldaanvraag

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2025-01-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "isIPv6Enabled": "Enabled",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7
  }
}

Voorbeeldrespons

Statuscode:
200 
{
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "kind": "v12.0",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "isIPv6Enabled": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "description": "Auto-approved",
            "actionsRequired": "None",
            "status": "Approved"
          },
          "provisioningState": "Ready"
        }
      }
    ],
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7,
    "state": "Ready",
    "version": "12.0"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}
Statuscode:
202 
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01

Definities

Name Description
AdministratorType

Type van de serverbeheerder.
createdByType

Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ExternalGovernanceStatus

Status van extern beheer.
IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.
MinimalTlsVersion

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
PrincipalType

Principal-type van de serverbeheerder.
PrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.
PrivateEndpointProperty
PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.
PrivateLinkServiceConnectionStateActionsRequire

De acties die nodig zijn voor de private link-serviceverbinding.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.
ResourceIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.
Server

An Azure SQL Database server.
ServerCreateMode

Maakmodus voor server, alleen geldige waarden hiervoor zijn Normaal en Herstellen.
ServerExternalAdministrator

Eigenschappen van een Active Directory-beheerder.
ServerNetworkAccessFlag

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server
ServerPublicNetworkAccessFlag

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
ServerUpdate

Een updateverzoek voor een Azure SQL Database-server.
ServerWorkspaceFeature

Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.

AdministratorType

Opsomming

Type van de serverbeheerder.

Waarde Description
ActiveDirectory

Active Directory

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ExternalGovernanceStatus

Opsomming

Status van extern beheer.

Waarde Description
Enabled

Ingeschakeld
Disabled

Disabled

IdentityType

Opsomming

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.

Waarde Description
None

Geen
SystemAssigned

SysteemToegewezen
UserAssigned

UserAssigned
SystemAssigned,UserAssigned

SysteemToegewezen, GebruikerToegewezen

MinimalTlsVersion

Opsomming

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'

Waarde Description
None

Geen
1.0

1.0
1.1

1,1
1.2

1,2
1.3

1.3

PrincipalType

Opsomming

Principal-type van de serverbeheerder.

Waarde Description
User

Gebruiker
Group

Groep
Application

Application

PrivateEndpointConnectionProperties

Object

Eigenschappen van een privé-eindpuntverbinding.

Name Type Description
groupIds

string[]

Groeps-id's.
privateEndpoint

PrivateEndpointProperty

Privé-eindpunt waartoe de verbinding behoort.
privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Verbindingsstatus van de privé-eindpuntverbinding.
provisioningState

PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

PrivateEndpointProperty

Object
Name Type Description
id

string

Resource-id van het privé-eindpunt.

PrivateEndpointProvisioningState

Opsomming

Status van de privé-eindpuntverbinding.

Waarde Description
Approving

Goedkeuring
Ready

Klaar
Dropping

Dropping
Failed

Mislukt
Rejecting

Afwijzing

PrivateLinkServiceConnectionStateActionsRequire

Opsomming

De acties die nodig zijn voor de private link-serviceverbinding.

Waarde Description
None

Geen

PrivateLinkServiceConnectionStateProperty

Object
Name Type Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

De acties die nodig zijn voor de private link-serviceverbinding.
description

string

De beschrijving van de private link-serviceverbinding.
status

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

PrivateLinkServiceConnectionStateStatus

Opsomming

De verbindingsstatus van de Private Link-service.

Waarde Description
Approved

Goedgekeurd
Pending

In afwachting
Rejected

Afgewezen
Disconnected

Ontkoppeld

ResourceIdentity

Object

Azure Active Directory identiteitsconfiguratie voor een resource.

Name Type Description
principalId

string (uuid)

De principal id van Azure Active Directory.
tenantId

string (uuid)

De Azure Active Directory tenant id.
type

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.
userAssignedIdentities

<string,  UserIdentity>

De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt

Server

Object

An Azure SQL Database server.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.
kind

string

Soort SQL-server. Dit is metadata die wordt gebruikt voor de Azure-portaalervaring.
location

string

De geografische locatie waar de resource zich bevindt
name

string

De naam van de resource
properties.administratorLogin

string

Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword

string (password)

Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators

ServerExternalAdministrator

De Azure Active Directory-beheerder kan worden gebruikt tijdens servercreatie en voor serverupdates, behalve voor de azureADOnlyAuthentication-eigenschap. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API worden gebruikt.
properties.createMode

ServerCreateMode

Maakmodus voor server, alleen geldige waarden hiervoor zijn Normaal en Herstellen.
properties.externalGovernanceStatus

ExternalGovernanceStatus

Status van extern beheer.
properties.federatedClientId

string (uuid)

De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.fullyQualifiedDomainName

string

De volledig gekwalificeerde domeinnaam van de server.
properties.isIPv6Enabled

ServerNetworkAccessFlag

Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion

MinimalTlsVersion

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId

string

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.retentionDays

integer (int32)

Het aantal dagen dat deze server voorlopig verwijderd blijft.
properties.state

string

De status van de server.
properties.version

string

De versie van de server.
properties.workspaceFeature

ServerWorkspaceFeature

Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
systemData

systemData

Azure Resource Manager metadata met creationBy en modifiedBy informatie.
tags

object

Resourcetags.
type

string

Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts"

ServerCreateMode

Opsomming

Maakmodus voor server, alleen geldige waarden hiervoor zijn Normaal en Herstellen.

Waarde Description
Normal

Normaal
Restore

Herstellen

ServerExternalAdministrator

Object

Eigenschappen van een Active Directory-beheerder.

Name Type Description
administratorType

AdministratorType

Type van de serverbeheerder.
azureADOnlyAuthentication

boolean

Azure Active Directory alleen authenticatie ingeschakeld.
login

string

Aanmeldingsnaam van de serverbeheerder.
principalType

PrincipalType

Principal-type van de serverbeheerder.
sid

string (uuid)

SID (object-id) van de serverbeheerder.
tenantId

string (uuid)

Tenant-id van de beheerder.

ServerNetworkAccessFlag

Opsomming

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

Waarde Description
Enabled

Ingeschakeld
Disabled

Disabled

ServerPrivateEndpointConnection

Object

Een privé-eindpuntverbinding onder een server

Name Type Description
id

string

Resource-ID.
properties

PrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

ServerPublicNetworkAccessFlag

Opsomming

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn

Waarde Description
Enabled

Ingeschakeld
Disabled

Disabled
SecuredByPerimeter

Beveiligd doorPerimeter

ServerUpdate

Object

Een updateverzoek voor een Azure SQL Database-server.

Name Type Description
identity

ResourceIdentity

Serveridentiteit
properties.administratorLogin

string

Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword

string (password)

Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators

ServerExternalAdministrator

De Azure Active Directory-beheerder kan worden gebruikt tijdens servercreatie en voor serverupdates, behalve voor de azureADOnlyAuthentication-eigenschap. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API worden gebruikt.
properties.createMode

ServerCreateMode

Maakmodus voor server, alleen geldige waarden hiervoor zijn Normaal en Herstellen.
properties.externalGovernanceStatus

ExternalGovernanceStatus

Status van extern beheer.
properties.federatedClientId

string (uuid)

De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.fullyQualifiedDomainName

string

De volledig gekwalificeerde domeinnaam van de server.
properties.isIPv6Enabled

ServerNetworkAccessFlag

Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion

MinimalTlsVersion

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId

string

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.retentionDays

integer (int32)

Het aantal dagen dat deze server voorlopig verwijderd blijft.
properties.state

string

De status van de server.
properties.version

string

De versie van de server.
properties.workspaceFeature

ServerWorkspaceFeature

Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
tags

object

Resourcetags.

ServerWorkspaceFeature

Opsomming

Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan

Waarde Description
Connected

Connected
Disconnected

Ontkoppeld

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserIdentity

Object

Azure Active Directory identiteitsconfiguratie voor een resource.

Name Type Description
clientId

string (uuid)

De Azure Active Directory client id.
principalId

string (uuid)

De principal id van Azure Active Directory.