다음을 통해 공유


Communication Services - Check Name Availability

이름 가용성 확인
CommunicationService 이름이 유효하고 아직 사용되지 않는지 확인합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
subscriptionId
path True

string

uuid

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
name True

string

가용성을 확인해야 하는 리소스의 이름입니다.

type True

string

리소스 종류입니다.

응답

Name 형식 Description
200 OK

CheckNameAvailabilityResponse

성공. 응답은 이름 가용성을 설명합니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

Check name availability available
Check name availability unavailable

Check name availability available

샘플 요청

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"
}

샘플 응답

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

Check name availability unavailable

샘플 요청

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"
}

샘플 응답

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

정의

Name Description
CheckNameAvailabilityReason

지정된 이름을 사용할 수 없는 이유입니다.

CheckNameAvailabilityResponse

가용성 확인 결과입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

NameAvailabilityParameters

nameAvailability 작업에 대한 데이터 POST-ed

CheckNameAvailabilityReason

지정된 이름을 사용할 수 없는 이유입니다.

Name 형식 Description
AlreadyExists

string

Invalid

string

CheckNameAvailabilityResponse

가용성 확인 결과입니다.

Name 형식 Description
message

string

지정된 이름을 사용할 수 있는 자세한 이유입니다.

nameAvailable

boolean

리소스 이름을 사용할 수 있는지를 나타냅니다.

reason

CheckNameAvailabilityReason

지정된 이름을 사용할 수 없는 이유입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

NameAvailabilityParameters

nameAvailability 작업에 대한 데이터 POST-ed

Name 형식 Description
name

string

가용성을 확인해야 하는 리소스의 이름입니다.

type

string

리소스 종류입니다.