Delen via


Servers - Create Or Update

Hiermee wordt een server gemaakt of bijgewerkt.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.

serverName
path True

string

De naam van de server.

subscriptionId
path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.

api-version
query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name Vereist Type Description
location True

string

Resourcelocatie.

identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.

properties.administratorLogin

string

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

properties.administratorLoginPassword

string

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

properties.administrators

ServerExternalAdministrator

De Azure Active Directory-beheerder van de server.

properties.federatedClientId

string

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

properties.keyId

string

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

properties.minimalTlsVersion

string

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

properties.primaryUserAssignedIdentityId

string

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

properties.publicNetworkAccess

ServerNetworkAccessFlag

Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

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

properties.version

string

De versie van de server.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

Server

De server is bijgewerkt.

201 Created

Server

De server is gemaakt.

202 Accepted

Geaccepteerd

Other Status Codes

Foutreacties: ***

  • 400 MissingIdentityId - Er wordt geen door de gebruiker toegewezen identiteit opgegeven wanneer het identiteitstype is ingesteld op UserAssigned

  • 400 InvalidPrimaryIdentityId - Gebruiker geeft een waarde op voor PrimaryUserIdentityId, maar hetzelfde wordt niet vermeld in de parameter IdentityId

  • 400 PECsNotExistingToDenyPublicNetworkAccess - Kan Openbare netwerktoegang weigeren niet instellen op Ja omdat er geen privé-eindpunt is ingeschakeld voor toegang tot de server. Stel privé-eindpunten in en voer de bewerking opnieuw uit (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).

  • 400 NameAlreadyExists : de opgegeven naam bestaat al.

  • 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId die door de gebruiker is opgegeven, heeft geen toegang tot opgegeven KeyId

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId die door de gebruiker is opgegeven, heeft geen toegang tot de opgegeven KeyId

  • 400 ProvisioningDisabled - Geeft een foutbericht weer van de resource operation authorizer zoals het is, zonder wijzigingen

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId wordt opgegeven door de gebruiker tijdens het maken, maar PrimaryUserAssignedIdentityId is niet opgegeven in de API-aanroep

  • 400 InvalidIdentityTypeForKeyId - KeyId wordt opgegeven door de gebruiker tijdens het maken, maar het identiteitstype is niet ingesteld op 'UserAssigned'

  • 400 InvalidLoginName - De opgegeven aanmeldingsnaam is ongeldig.

  • 400 InvalidUsername - Opgegeven gebruikersnaam bevat ongeldige tekens.

  • 400 Ipv6FeatureNotEnabled - Gebruiker heeft geprobeerd ipv6-ondersteuning in te schakelen op de server zonder functievlag in te schakelen voor het abonnement, of de functieondersteuning is momenteel uitgeschakeld in de regio.

  • 400 PasswordTooShort - Het opgegeven wachtwoord is te kort

  • 400 AadOnlyAuthenticationIsEnabled - Alleen Azure Active Directory-verificatie is ingeschakeld. Neem contact op met de systeembeheerder.

  • 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund.

  • 400 PasswordTooLong - Het opgegeven wachtwoord is te lang.

  • 400 PasswordNotComplex - Het opgegeven wachtwoord is niet complex genoeg.

  • 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter.

  • 400 InvalidLocation - Er is een ongeldige locatie opgegeven.

  • 400 InvalidServerName - Ongeldige servernaam opgegeven.

  • 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken.

  • 400 TokenTooLong : het opgegeven token is te lang.

  • 400 RegionDoesNotAllowProvisioning - De geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan op een later tijdstip veranderen.

  • 400 ServerNotFound - De aangevraagde server is niet gevonden.

  • 400 InvalidMinimalTlsVersion - Ongeldige minimale TLS-versie.

  • 400 InvalidExternalAdministratorLogin - Ongeldige of ontbrekende aanmeldingsnaam van externe beheerder.

  • 400 InvalidExternalAdministratorSid - Ongeldige of ontbrekende object-id van externe beheerder.

  • 400 InvalidExternalAdministratorTenantId - Ongeldige of ontbrekende tenant-id van de externe beheerder.

  • 400 ExternalAdministratorPrincipalType : ongeldig of ontbreekt het principaltype van de externe beheerder. Selecteer een gebruiker, toepassing of groep.

  • 400 MissingExternalAdministratorWithAadOnlyAuth - Geef de details van een externe beheerder op om Azure AD Alleen verificatie te gebruiken.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin: de namen van de Azure Active Directory-beheerder en van het serverbeheerdersaccount moeten verschillen. Geef verschillende waarden op.

  • 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden

  • 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden.

  • 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker.

  • 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.

  • 409 UpsertLogicalServerRequestAlreadyInProgress - Er wordt al een aanvraag voor een logische server uitgevoerd. Probeer het later opnieuw.

  • 409 ServerDisabled - Server is uitgeschakeld.

  • 409 ConflictingServerOperation : er wordt momenteel een bewerking uitgevoerd voor de server.

  • 409 SubscriptionDisabled - Abonnement is uitgeschakeld.

  • 409 ServerQuotaExceeded - Server kan niet worden toegevoegd aan een abonnement omdat het quotum wordt overschreden.

  • 409 ServerAlreadyExists - Dubbele servernaam.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 ConflictingSubscriptionOperation : er wordt momenteel een bewerking uitgevoerd voor het abonnement.

  • 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Create server

Voorbeeldaanvraag

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

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}

Voorbeeldrespons

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Definities

Name Description
AdministratorType

Type van de serverbeheerder.

IdentityType

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

PrincipalType

Principal Type van de serverbeheerder.

PrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

PrivateLinkServiceConnectionStateActionsRequire

De acties die zijn vereist voor een private link-serviceverbinding.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Server

Een Azure SQL Database-server.

ServerExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

ServerNetworkAccessFlag

Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server

ServerWorkspaceFeature

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

UserIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

AdministratorType

Type van de serverbeheerder.

Name Type Description
ActiveDirectory

string

IdentityType

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

Name Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Principal Type van de serverbeheerder.

Name Type Description
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

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

Name Type Description
id

string

Resource-id van het privé-eindpunt.

PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

Name Type Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

De acties die zijn vereist voor een private link-serviceverbinding.

Name Type Description
None

string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

De acties die zijn vereist voor een private link-serviceverbinding.

description

string

De beschrijving van de private link-serviceverbinding.

status

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

Name Type Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name Type Description
principalId

string

De principal-id van Azure Active Directory.

tenantId

string

De tenant-id van Azure Active Directory.

type

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource 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

Een Azure SQL Database-server.

Name Type Description
id

string

Resource-id.

identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.

kind

string

Soort SQL-server. Dit zijn metagegevens die worden gebruikt voor de Azure Portal ervaring.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.administratorLogin

string

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

properties.administratorLoginPassword

string

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

properties.administrators

ServerExternalAdministrator

De Azure Active Directory-beheerder van de server.

properties.federatedClientId

string

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

properties.fullyQualifiedDomainName

string

De fully qualified domain name van de server.

properties.keyId

string

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

properties.minimalTlsVersion

string

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

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

ServerNetworkAccessFlag

Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

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

properties.state

string

De status van de server.

properties.version

string

De versie van de server.

properties.workspaceFeature

ServerWorkspaceFeature

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

tags

object

Resourcetags.

type

string

Resourcetype.

ServerExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

Name Type Description
administratorType

AdministratorType

Type van de serverbeheerder.

azureADOnlyAuthentication

boolean

Alleen Azure Active Directory-verificatie ingeschakeld.

login

string

Aanmeldingsnaam van de serverbeheerder.

principalType

PrincipalType

Principal Type van de serverbeheerder.

sid

string

SID (object-id) van de serverbeheerder.

tenantId

string

Tenant-id van de beheerder.

ServerNetworkAccessFlag

Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

Name Type Description
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server

Name Type Description
id

string

Resource-id.

properties

PrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

ServerWorkspaceFeature

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

Name Type Description
Connected

string

Disconnected

string

UserIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name Type Description
clientId

string

De Azure Active Directory-client-id.

principalId

string

De principal-id van Azure Active Directory.