Compartilhar via

Servers - Create Or Update

Serviço:
SQL Database
Versão da API:
2025-01-01

Cria ou atualiza um servidor.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID da 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 da solicitação

Nome Obrigatório Tipo Description
location True

string

Local do recurso.
identity

ResourceIdentity

A identidade do Azure Active Directory do servidor.
properties.administratorLogin

string

Nome de usuário do administrador para o servidor. Uma vez criado, ele não pode ser alterado.
properties.administratorLoginPassword

string

A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory pode ser utilizado durante a criação do servidor e para atualizações do servidor, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.
properties.createMode

ServerCreateMode

Modo de criação para o servidor, apenas os valores válidos para isso são Normal e Restaurar.
properties.federatedClientId

string (uuid)

A ID do cliente usada para o cenário de CMK entre locatários
properties.isIPv6Enabled

ServerNetworkAccessFlag

Se deseja ou não habilitar o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.keyId

string

Um URI do CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion

MinimalTlsVersion

Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId

string

A ID de recurso de uma identidade atribuída pelo 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 "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.retentionDays

integer (int32)

Número de dias em que este servidor permanecerá excluído de forma reversível.
properties.version

string

A versão do servidor.
tags

object

Tags de recursos.

Respostas

Nome Tipo Description
200 OK

Server

Atualizou com êxito o servidor.
201 Created

Server

O servidor foi criado com êxito.
202 Accepted

Aceitado

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 é usado por um servidor em estado de exclusão reversível. Limpe ou recupere o servidor para desbloquear.

  • 400 MissingIdentityId - Nenhuma identidade atribuída pelo 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 repita 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 mensagem de erro do autorizador de operação de recursos como está, sem alterações

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API

  • 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não é definido como 'UserAssigned'

  • 400 InvalidLoginName – O nome de logon 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 ao Ipv6 no servidor sem habilitar o sinalizador de recursos na assinatura ou o suporte ao recurso está desabilitado na região no momento.

  • 400 PasswordTooShort - A senha fornecida é muito curta

  • 400 AadOnlyAuthenticationIsEnabled – Autenticação Somente do Azure Active Directory 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 não há suporte para essa versão do servidor.

  • 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 – Um local inválido foi especificado.

  • 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 Azure Key Vault.

  • 400 RegionDoesNotAllowProvisioning - O local selecionado não está aceitando novos servidores do Banco de Dados SQL do Windows Azure. Isso pode mudar posteriormente.

  • 400 ServerNotFound – O servidor solicitado não foi encontrado.

  • 400 InvalidMinimalTlsVersion – versão mínima inválida do TLS.

  • 400 InvalidExternalAdministratorLogin – Nome de logon de administrador externo inválido ou ausente.

  • 400 InvalidExternalAdministratorSid – ID de objeto de administrador externo inválida ou ausente.

  • 400 InvalidExternalAdministratorTenantId – ID de locatário de administrador externo inválida ou ausente.

  • 400 ExternalAdministratorPrincipalType - Tipo de entidade de segurança de administrador externo inválido ou ausente. Selecione entre Usuário, Aplicativo ou Grupo.

  • 400 MissingExternalAdministratorWithAadOnlyAuth – Para usar a Autenticação Somente do Azure AD, forneça detalhes de um administrador externo.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin - Os nomes do administrador do Azure Active Directory e da conta de administrador do servidor devem ser diferentes. Forneça valores diferentes.

  • 400 ServerAdministratorNameAlreadyExists – o usuário tentou definir o administrador externo e o nome principal já existe no banco de dados 'mestre'.

  • 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 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á desabilitado.

  • 409 ConflictingServerOperation – Uma operação está em andamento para o servidor.

  • 409 SubscriptionDisabled – A assinatura está desabilitada.

  • 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 por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 ConflictingSubscriptionOperation – Uma operação está em andamento para a assinatura.

  • 500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Create server

Solicitação de exemplo

PUT 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",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "createMode": "Normal",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled",
    "retentionDays": 7
  },
  "location": "Japan East"
}

Resposta de exemplo

Código de status:
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",
    "retentionDays": 7,
    "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 status:
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",
    "retentionDays": 7,
    "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 status:
202

Definições

Nome Description
AdministratorType

Tipo do administrador de sever.
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
ExternalGovernanceStatus

Status da governança externa.
IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
MinimalTlsVersion

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

Tipo de entidade de segurança do administrador de sever.
PrivateEndpointConnectionProperties

Propriedades de uma conexão de ponto de extremidade privado.
PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.
PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a conexão do 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 Active Directory para um recurso.
Server

Um servidor do Banco de Dados SQL do Azure.
ServerCreateMode

Modo de criação para o servidor, apenas os valores válidos para isso são Normal e Restaurar.
ServerExternalAdministrator

Propriedades de um administrador do active directory.
ServerNetworkAccessFlag

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
ServerPrivateEndpointConnection

Uma conexão de ponto de extremidade privado 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 "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
ServerWorkspaceFeature

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
UserIdentity

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

AdministratorType

Enumeração

Tipo do administrador de sever.

Valor Description
ActiveDirectory

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
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

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ExternalGovernanceStatus

Enumeração

Status da governança externa.

Valor Description
Enabled
Disabled

IdentityType

Enumeração

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.

Valor Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

Enumeração

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

Valor Description
None
1.0
1.1
1.2
1.3

PrincipalType

Enumeração

Tipo de entidade de segurança do administrador de sever.

Valor Description
User
Group
Application

PrivateEndpointConnectionProperties

Objeto

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

Nome Tipo Description
groupIds

string[]

IDs de grupo.
privateEndpoint

PrivateEndpointProperty

Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Estado de conexão da conexão de ponto de extremidade privado.
provisioningState

PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.

PrivateEndpointProperty

Objeto
Nome 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
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeração

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

Valor Description
None

PrivateLinkServiceConnectionStateProperty

Objeto
Nome Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a conexão do 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
Pending
Rejected
Disconnected

ResourceIdentity

Objeto

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

Nome Tipo Description
principalId

string (uuid)

A ID da entidade de segurança do Azure Active Directory.
tenantId

string (uuid)

A ID do locatário do Azure Active Directory.
type

IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
userAssignedIdentities

<string,  UserIdentity>

As IDs de recurso das identidades atribuídas pelo usuário a serem usadas

Server

Objeto

Um servidor do Banco de Dados SQL do Azure.

Nome Tipo Description
id

string

ID do recurso.
identity

ResourceIdentity

A identidade do Azure Active Directory do servidor.
kind

string

Tipo de sql server. Esses são metadados usados para a experiência do portal do Azure.
location

string

Local do recurso.
name

string

Nome do recurso.
properties.administratorLogin

string

Nome de usuário do administrador para o servidor. Uma vez criado, ele não pode ser alterado.
properties.administratorLoginPassword

string

A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory pode ser utilizado durante a criação do servidor e para atualizações do servidor, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.
properties.createMode

ServerCreateMode

Modo de criação para o servidor, apenas os valores válidos para isso são Normal e Restaurar.
properties.externalGovernanceStatus

ExternalGovernanceStatus

Status da governança externa.
properties.federatedClientId

string (uuid)

A ID do cliente usada para o cenário de CMK entre locatários
properties.fullyQualifiedDomainName

string

O nome de domínio totalmente qualificado do servidor.
properties.isIPv6Enabled

ServerNetworkAccessFlag

Se deseja ou não habilitar o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.keyId

string

Um URI do CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion

MinimalTlsVersion

Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId

string

A ID de recurso de uma identidade atribuída pelo 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 "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.retentionDays

integer (int32)

Número de dias em que este servidor permanecerá excluído de forma reversível.
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 workspace criado e se ele permite a conexão do workspace
tags

object

Tags de recursos.
type

string

Tipo de recurso.

ServerCreateMode

Enumeração

Modo de criação para o servidor, apenas os valores válidos para isso são Normal e Restaurar.

Valor Description
Normal
Restore

ServerExternalAdministrator

Objeto

Propriedades de um administrador do active directory.

Nome Tipo Description
administratorType

AdministratorType

Tipo do administrador de sever.
azureADOnlyAuthentication

boolean

Somente autenticação do Azure Active Directory habilitada.
login

string

Nome de logon do administrador do servidor.
principalType

PrincipalType

Tipo de entidade de segurança do administrador de sever.
sid

string (uuid)

SID (ID do objeto) do administrador do servidor.
tenantId

string (uuid)

ID do locatário do administrador.

ServerNetworkAccessFlag

Enumeração

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'

Valor Description
Enabled
Disabled

ServerPrivateEndpointConnection

Objeto

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

Nome 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 "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"

Valor Description
Enabled
Disabled
SecuredByPerimeter

ServerWorkspaceFeature

Enumeração

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace

Valor Description
Connected
Disconnected

UserIdentity

Objeto

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

Nome Tipo Description
clientId

string (uuid)

A ID do cliente do Azure Active Directory.
principalId

string (uuid)

A ID da entidade de segurança do Azure Active Directory.