Servers - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2023-08-01

Cria ou atualiza um servidor.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso.
identity		ResourceIdentity	A identidade do Azure Ative Directory do servidor.
properties.administratorLogin		string	Nome de usuário do administrador para o servidor. Uma vez criado, não pode ser alterado.
properties.administratorLoginPassword		string	A senha de login do administrador (necessária para a criação do servidor).
properties.administrators		ServerExternalAdministrator	O administrador do Azure Ative Directory do servidor. Isso só pode ser usado no momento da criação do servidor. Se usado para atualização do servidor, ele será ignorado ou resultará em um erro. Para atualizações, APIs individuais precisarão ser usadas.
properties.federatedClientId		string (uuid)	A ID do cliente usada para o cenário CMK entre locatários
properties.isIPv6Enabled		ServerNetworkAccessFlag	Ativar ou não o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'
properties.keyId		string	Um URI CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion		MinimalTlsVersion	Versão TLS mínima. Valores permitidos: 'Nenhum', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId		string	A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.
properties.publicNetworkAccess		ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser 'Enabled' ou 'Disabled' ou 'SecuredByPerimeter'
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Restringir ou não o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'
properties.version		string	A versão do servidor.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	Server	Atualizado com êxito o servidor.
201 Created	Server	Criado com êxito o servidor.
202 Accepted		Aceito Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Respostas de erro: *** 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está no estado de parada/parada 400 ManagedInstanceStarting - Operação conflitante enviada enquanto a instância está no estado inicial 400 NameAlreadyExistsSoftDeleted - O nome do servidor solicitado é obtido por um servidor no estado soft delete. Limpe ou recupere o servidor para desbloquear. 400 MissingIdentityId - Nenhuma identidade atribuída ao usuário é fornecida quando o tipo de identidade é definido como UserAssigned 400 InvalidPrimaryIdentityId - O usuário fornece um valor para PrimaryUserIdentityId, mas o mesmo não está listado no parâmetro IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess - Não é possível definir Negar Acesso à Rede Pública como Sim, pois não há nenhum ponto de extremidade privado habilitado para acessar o servidor. Configure pontos de extremidade privados e tente novamente a operação (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists - O nome fornecido já existe. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido 400 ProvisioningDisabled - Exibe a mensagem de erro do autorizador da operação de recursos no estado em que se encontra, sem alterações 400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada da API 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não está definido como 'UserAssigned' 400 InvalidLoginName - O nome de login fornecido é inválido. 400 InvalidUsername - O nome de usuário fornecido contém caracteres inválidos. 400 Ipv6FeatureNotEnabled - O usuário tentou ativar o suporte a Ipv6 no servidor sem ativar o sinalizador de recurso na assinatura, ou o suporte ao recurso está atualmente desativado na região. 400 PasswordTooShort - A senha fornecida é muito curta 400 AadOnlyAuthenticationIsEnabled - A Autenticação Apenas do Ative Directory do Azure está habilitada. Entre em contato com o administrador do sistema. 400 RegionDoesNotSupportVersion - Um usuário tentou criar um servidor de uma versão especificada em um local onde essa versão do servidor não é suportada. 400 PasswordTooLong - A senha fornecida é muito longa. 400 PasswordNotComplex - A senha fornecida não é complexa o suficiente. 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 400 InvalidLocation - Foi especificado um local inválido. 400 InvalidServerName - Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 TokenTooLong - O token fornecido é muito longo. 400 CMKOperationNotAllowed - O usuário tentou executar uma operação no servidor quando o servidor não tinha acesso ao Cofre da Chave do Azure. 400 ServerNotFound - O servidor solicitado não foi encontrado. 400 RegionDoesNotAllowProvisioning - O local selecionado não está aceitando novos servidores do Banco de dados SQL do Windows Azure. Isso pode mudar posteriormente. 400 InvalidMinimalTlsVersion - Versão TLS mínima inválida. 400 InvalidExternalAdministratorLogin - Nome de login de administrador externo inválido ou ausente. 400 InvalidExternalAdministratorSid - ID de objeto de administrador externo inválido ou ausente. 400 InvalidExternalAdministratorTenantId - ID de locatário de administrador externo inválido ou ausente. 400 ExternalAdministratorPrincipalType - Tipo de entidade de administrador externo inválido ou ausente. Selecione entre Usuário, Aplicativo ou Grupo. 400 MissingExternalAdministratorWithAadOnlyAuth - Para usar a Autenticação Apenas do Azure AD, forneça detalhes de um administrador externo. 400 ExternalAdministratorLoginSameAsSqlAdmin - Os nomes do administrador do Azure Ative Directory e da conta de administrador do servidor devem ser diferentes. Por favor, forneça valores diferentes. 400 ServerAdministratorNameAlreadyExists - O usuário tentou definir o administrador externo e o nome principal já existe no banco de dados 'master'. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 OperationIdNotFound - A operação com Id não existe. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 409 UpsertLogicalServerRequestAlreadyInProgress - Uma solicitação de servidor lógico em andamento já está em andamento, tente sua solicitação novamente mais tarde. 409 ServerDisabled - O servidor está desativado. 409 ConflictingServerOperation - Uma operação está atualmente em andamento para o servidor. 409 SubscriptionDisabled - A subscrição está desativada. 409 ServerQuotaExceeded - O servidor não pode ser adicionado a uma assinatura porque excederá a cota. 409 ServerAlreadyExists - Nome do servidor duplicado. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 ConflictingSubscriptionOperation - Uma operação está atualmente em andamento para a assinatura. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Create server

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2023-08-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",
    "isIPv6Enabled": "Enabled"
  },
  "location": "Japan East"
}

Resposta da amostra

Código de estado:: 200

{
  "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",
    "isIPv6Enabled": "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"
          }
        }
      }
    ]
  }
}

Código de estado:: 201

{
  "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",
    "isIPv6Enabled": "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"
          }
        }
      }
    ]
  }
}

Código de estado:: 202

Definições

Name	Description
AdministratorType	Tipo de administrador de corte.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExternalGovernanceStatus	Estatuto da governação externa.
IdentityType	O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.
MinimalTlsVersion	Versão TLS mínima. Valores permitidos: 'Nenhum', 1.0', '1.1', '1.2', '1.3'
PrincipalType	Tipo principal do administrador de corte.
PrivateEndpointConnectionProperties	Propriedades de uma conexão de ponto de extremidade privada.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Estado da conexão de ponto de extremidade privado.
PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para conexão de serviço de link privado.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	O status da conexão do serviço de link privado.
ResourceIdentity	Configuração de identidade do Azure Ative Directory para um recurso.
Server	Um servidor do Banco de Dados SQL do Azure.
ServerExternalAdministrator	Propriedades de um administrador do Ative Directory.
ServerNetworkAccessFlag	Restringir ou não o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'
ServerPrivateEndpointConnection	Uma conexão de ponto de extremidade privada em um servidor
ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser 'Enabled' ou 'Disabled' ou 'SecuredByPerimeter'
ServerWorkspaceFeature	Se o servidor existente tem ou não um espaço de trabalho criado e se ele permite a conexão do espaço de trabalho
UserIdentity	Configuração de identidade do Azure Ative Directory para um recurso.

AdministratorType

Enumeração

Tipo de administrador de corte.

Valor	Description
ActiveDirectory

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExternalGovernanceStatus

Enumeração

Estatuto da governação externa.

Valor	Description
Disabled
Enabled

IdentityType

Enumeração

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

Valor	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Enumeração

Versão TLS mínima. Valores permitidos: 'Nenhum', 1.0', '1.1', '1.2', '1.3'

Valor	Description
1.0
1.1
1.2
1.3
None

PrincipalType

Enumeração

Tipo principal do administrador de corte.

Valor	Description
Application
Group
User

PrivateEndpointConnectionProperties

Object

Propriedades de uma conexão de ponto de extremidade privada.

Name	Tipo	Description
groupIds	string[]	IDs de grupo.
privateEndpoint	PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado da conexão da conexão de ponto de extremidade privado.
provisioningState	PrivateEndpointProvisioningState	Estado da conexão de ponto de extremidade privado.

PrivateEndpointProperty

Object

Name	Tipo	Description
id	string	ID do recurso do ponto de extremidade privado.

PrivateEndpointProvisioningState

Enumeração

Estado da conexão de ponto de extremidade privado.

Valor	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeração

As ações necessárias para conexão de serviço de link privado.

Valor	Description
None

PrivateLinkServiceConnectionStateProperty

Object

Name	Tipo	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para conexão de serviço de link privado.
description	string	A descrição da conexão do serviço de link privado.
status	PrivateLinkServiceConnectionStateStatus	O status da conexão do serviço de link privado.

PrivateLinkServiceConnectionStateStatus

Enumeração

O status da conexão do serviço de link privado.

Valor	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Object

Configuração de identidade do Azure Ative Directory para um recurso.

Name	Tipo	Description
principalId	string (uuid)	A ID principal do Azure Ative Directory.
tenantId	string (uuid)	A ID de locatário do Azure Ative Directory.
type	IdentityType	O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.
userAssignedIdentities	<string, UserIdentity>	As ids de recurso das identidades atribuídas ao usuário a serem usadas

Server

Object

Um servidor do Banco de Dados SQL do Azure.

Name	Tipo	Description
id	string	ID do recurso.
identity	ResourceIdentity	A identidade do Azure Ative Directory do servidor.
kind	string	Tipo de servidor sql. Esses são metadados usados para a experiência do portal do Azure.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.administratorLogin	string	Nome de usuário do administrador para o servidor. Uma vez criado, não pode ser alterado.
properties.administratorLoginPassword	string	A senha de login do administrador (necessária para a criação do servidor).
properties.administrators	ServerExternalAdministrator	O administrador do Azure Ative Directory do servidor. Isso só pode ser usado no momento da criação do servidor. Se usado para atualização do servidor, ele será ignorado ou resultará em um erro. Para atualizações, APIs individuais precisarão ser usadas.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Estatuto da governação externa.
properties.federatedClientId	string (uuid)	A ID do cliente usada para o cenário CMK entre locatários
properties.fullyQualifiedDomainName	string	O nome de domínio totalmente qualificado do servidor.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Ativar ou não o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'
properties.keyId	string	Um URI CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versão TLS mínima. Valores permitidos: 'Nenhum', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista de conexões de ponto de extremidade privado em um servidor
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser 'Enabled' ou 'Disabled' ou 'SecuredByPerimeter'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Restringir ou não o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'
properties.state	string	O estado do servidor.
properties.version	string	A versão do servidor.
properties.workspaceFeature	ServerWorkspaceFeature	Se o servidor existente tem ou não um espaço de trabalho criado e se ele permite a conexão do espaço de trabalho
tags	object	Tags de recursos.
type	string	Tipo de recurso.

ServerExternalAdministrator

Object

Propriedades de um administrador do Ative Directory.

Name	Tipo	Description
administratorType	AdministratorType	Tipo de administrador de corte.
azureADOnlyAuthentication	boolean	Somente Autenticação do Ative Directory do Azure habilitada.
login	string	Nome de login do administrador do servidor.
principalType	PrincipalType	Tipo principal do administrador de corte.
sid	string (uuid)	SID (ID do objeto) do administrador do servidor.
tenantId	string (uuid)	ID do locatário do administrador.

ServerNetworkAccessFlag

Enumeração

Restringir ou não o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado'

Valor	Description
Disabled
Enabled

ServerPrivateEndpointConnection

Object

Uma conexão de ponto de extremidade privada em um servidor

Name	Tipo	Description
id	string	ID do recurso.
properties	PrivateEndpointConnectionProperties	Propriedades de conexão de ponto de extremidade privado

ServerPublicNetworkAccessFlag

Enumeração

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser 'Enabled' ou 'Disabled' ou 'SecuredByPerimeter'

Valor	Description
Disabled
Enabled
SecuredByPerimeter

ServerWorkspaceFeature

Enumeração

Se o servidor existente tem ou não um espaço de trabalho criado e se ele permite a conexão do espaço de trabalho

Valor	Description
Connected
Disconnected

UserIdentity

Object

Configuração de identidade do Azure Ative Directory para um recurso.

Name	Tipo	Description
clientId	string (uuid)	A ID do cliente do Azure Ative Directory.
principalId	string (uuid)	A ID principal do Azure Ative Directory.

Partilhar via

Servers - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Create server

Pedido de amostra

Resposta da amostra

Definições

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerWorkspaceFeature

UserIdentity

Recursos adicionais