Partilhar via


Services - Check Name Availability

Verifica se o nome do serviço de pesquisa especificado está ou não disponível para utilização. Serviço de pesquisa nomes têm de ser globalmente exclusivos, uma vez que fazem parte do URI do serviço (https://.search.windows.net).

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Search/checkNameAvailability?api-version=2023-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
path True

string

O identificador exclusivo de uma subscrição do Microsoft Azure. Pode obter este valor a partir da API de Resource Manager do Azure, das ferramentas de linha de comandos ou do portal.

api-version
query True

string

A versão da API a utilizar para cada pedido.

Cabeçalho do Pedido

Name Necessário Tipo Description
x-ms-client-request-id

string

uuid

Um valor GUID gerado pelo cliente que identifica este pedido. Se for especificado, isto será incluído nas informações de resposta como forma de controlar o pedido.

Corpo do Pedido

Name Necessário Tipo Description
name True

string

O nome do serviço de pesquisa a validar. Serviço de pesquisa nomes só têm de conter letras minúsculas, dígitos ou traços, não podem utilizar traços como os dois primeiros ou últimos carateres, não podem conter traços consecutivos e têm de ter entre 2 e 60 carateres de comprimento.

type True

ResourceType

O tipo de recurso cujo nome deve ser validado. Este valor tem de ser sempre "searchServices".

Respostas

Name Tipo Description
200 OK

CheckNameAvailabilityOutput

A verificação de nome foi concluída. A resposta contém detalhes sobre se o nome é válido e está disponível. Se o nome for inválido, a resposta também contém uma mensagem a explicar porque não.

Other Status Codes

CloudError

HTTP 400 (Pedido Incorreto): o tipo de recurso especificado não é "searchServices".

Segurança

azure_auth

Microsoft Entra ID fluxo de autorização OAuth2.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

SearchCheckNameAvailability

Pedido de amostra

POST https://management.azure.com/subscriptions/subid/providers/Microsoft.Search/checkNameAvailability?api-version=2023-11-01

{
  "name": "mysearchservice",
  "type": "searchServices"
}

Resposta da amostra

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": ""
}

Definições

Name Description
CheckNameAvailabilityInput

Entrada da API de disponibilidade de nomes de verificação.

CheckNameAvailabilityOutput

Saída da API de disponibilidade de nomes de verificação.

CloudError

Contém informações sobre um erro de API.

CloudErrorBody

Descreve um erro específico da API com um código de erro e uma mensagem.

ResourceType

O tipo de recurso cujo nome deve ser validado. Este valor tem de ser sempre "searchServices".

UnavailableNameReason

O motivo pelo qual o nome não está disponível. "Inválido" indica que o nome fornecido não corresponde aos requisitos de nomenclatura (comprimento incorreto, carateres não suportados, etc.). "AlreadyExists" indica que o nome já está a ser utilizado e, portanto, está indisponível.

CheckNameAvailabilityInput

Entrada da API de disponibilidade de nomes de verificação.

Name Tipo Description
name

string

O nome do serviço de pesquisa a validar. Serviço de pesquisa nomes só têm de conter letras minúsculas, dígitos ou traços, não podem utilizar traços como os dois primeiros ou últimos carateres, não podem conter traços consecutivos e têm de ter entre 2 e 60 carateres de comprimento.

type

ResourceType

O tipo de recurso cujo nome deve ser validado. Este valor tem de ser sempre "searchServices".

CheckNameAvailabilityOutput

Saída da API de disponibilidade de nomes de verificação.

Name Tipo Description
message

string

Uma mensagem que explica por que motivo o nome é inválido e fornece requisitos de nomenclatura de recursos. Disponível apenas se "Inválido" for devolvido na propriedade "reason".

nameAvailable

boolean

Um valor que indica se o nome está disponível.

reason

UnavailableNameReason

O motivo pelo qual o nome não está disponível. "Inválido" indica que o nome fornecido não corresponde aos requisitos de nomenclatura (comprimento incorreto, carateres não suportados, etc.). "AlreadyExists" indica que o nome já está a ser utilizado e, portanto, está indisponível.

CloudError

Contém informações sobre um erro de API.

Name Tipo Description
error

CloudErrorBody

Descreve um erro específico da API com um código de erro e uma mensagem.

CloudErrorBody

Descreve um erro específico da API com um código de erro e uma mensagem.

Name Tipo Description
code

string

Um código de erro que descreve a condição de erro com mais precisão do que um código de estado HTTP. Pode ser utilizado para processar programaticamente casos de erro específicos.

details

CloudErrorBody[]

Contém erros aninhados relacionados com este erro.

message

string

Uma mensagem que descreve o erro em detalhe e fornece informações de depuração.

target

string

O destino do erro específico (por exemplo, o nome da propriedade em erro).

ResourceType

O tipo de recurso cujo nome deve ser validado. Este valor tem de ser sempre "searchServices".

Name Tipo Description
searchServices

string

"searchServices" é o único tipo de recurso cujo nome pode ser validado.

UnavailableNameReason

O motivo pelo qual o nome não está disponível. "Inválido" indica que o nome fornecido não corresponde aos requisitos de nomenclatura (comprimento incorreto, carateres não suportados, etc.). "AlreadyExists" indica que o nome já está a ser utilizado e, portanto, está indisponível.

Name Tipo Description
AlreadyExists

string

O nome do serviço de pesquisa já está atribuído a um serviço de pesquisa diferente.

Invalid

string

O nome do serviço de pesquisa não corresponde aos requisitos de nomenclatura.