Sdílet prostřednictvím


Communication Services - Check Name Availability

Kontrola dostupnosti názvu
Zkontroluje, jestli je název CommunicationService platný a už se nepoužívá.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
subscriptionId
path True

string

uuid

ID cílového předplatného. Hodnota musí být UUID.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Vyžadováno Typ Description
name True

string

Název prostředku, pro který je potřeba zkontrolovat dostupnost.

type True

string

Typ prostředku.

Odpovědi

Name Typ Description
200 OK

CheckNameAvailabilityResponse

Úspěch. Odpověď popisuje dostupnost názvu.

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Příklady

Check name availability available
Check name availability unavailable

Check name availability available

Ukázkový požadavek

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/providers/Microsoft.Communication/checkNameAvailability?api-version=2023-04-01

{
  "type": "Microsoft.Communication/CommunicationServices",
  "name": "MyCommunicationService"
}

Ukázková odpověď

{
  "nameAvailable": true,
  "reason": "NameAvailable",
  "message": "Requested name is available for the requested type"
}

Check name availability unavailable

Ukázkový požadavek

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/providers/Microsoft.Communication/checkNameAvailability?api-version=2023-04-01

{
  "type": "Microsoft.Communication/CommunicationServices",
  "name": "MyCommunicationService"
}

Ukázková odpověď

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "Requested name is unavailable for the requested type"
}

Definice

Name Description
CheckNameAvailabilityReason

Důvod, proč daný název není k dispozici.

CheckNameAvailabilityResponse

Výsledek kontroly dostupnosti.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

NameAvailabilityParameters

Data post-ed na akci nameAvailability

CheckNameAvailabilityReason

Důvod, proč daný název není k dispozici.

Name Typ Description
AlreadyExists

string

Invalid

string

CheckNameAvailabilityResponse

Výsledek kontroly dostupnosti.

Name Typ Description
message

string

Podrobný důvod, proč je daný název dostupný

nameAvailable

boolean

Označuje, jestli je název prostředku dostupný.

reason

CheckNameAvailabilityReason

Důvod, proč daný název není k dispozici.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

NameAvailabilityParameters

Data post-ed na akci nameAvailability

Name Typ Description
name

string

Název prostředku, pro který je potřeba zkontrolovat dostupnost.

type

string

Typ prostředku.