다음을 통해 공유

Accounts - Check Name Availability

  • 참조
서비스:
Azure Video Indexer
API 버전:
2024-01-01

Video Indexer 계정 이름이 유효하고 아직 사용되고 있지 않은지 확인합니다.

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

URI 매개 변수

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

string

대상 구독의 ID입니다.
api-version
 query True

string

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

요청 본문

Name 필수 형식 Description
name True

string

VideoIndexer 계정 이름입니다.
type True

Type

리소스 유형인 Microsoft.VideoIndexer/accounts

응답

Name 형식 Description
200 OK

CheckNameAvailabilityResult

확인 - Video Indexer 계정 이름 가용성을 검사 작업이 성공했습니다. 확인은 이름을 사용할 수 있음을 나타내지 않으며 응답 본문은 사용할 수 있습니다.
Other Status Codes

ErrorResponse

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

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Check free account name availability
Check taken account name availability

Check free account name availability

샘플 요청

POST https://management.azure.com/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/providers/Microsoft.VideoIndexer/checkNameAvailability?api-version=2024-01-01

{
  "name": "vi1",
  "type": "Microsoft.VideoIndexer/accounts"
}

샘플 응답

상태 코드:
200 
{
  "nameAvailable": true
}

Check taken account name availability

샘플 요청

POST https://management.azure.com/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/providers/Microsoft.VideoIndexer/checkNameAvailability?api-version=2024-01-01

{
  "name": "vi1",
  "type": "Microsoft.VideoIndexer/accounts"
}

샘플 응답

상태 코드:
200 
{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "Resource name already exists"
}

정의

Name Description
AccountCheckNameAvailabilityParameters

Video Indexer 계정 이름의 가용성을 검사 데 사용되는 매개 변수입니다.
CheckNameAvailabilityResult

CheckNameAvailability 작업 응답입니다.
ErrorDefinition

오류 정의.
ErrorResponse

오류 응답입니다.
Reason

Video Indexer 계정 이름을 사용할 수 없는 이유를 가져옵니다. Reason 요소는 NameAvailable이 false인 경우에만 반환됩니다.
Type

리소스 유형인 Microsoft.VideoIndexer/accounts

AccountCheckNameAvailabilityParameters

Video Indexer 계정 이름의 가용성을 검사 데 사용되는 매개 변수입니다.

Name 형식 Description
name

string

VideoIndexer 계정 이름입니다.
type

Type

리소스 유형인 Microsoft.VideoIndexer/accounts

CheckNameAvailabilityResult

CheckNameAvailability 작업 응답입니다.

Name 형식 Description
message

string

Reason 값을 자세히 설명하는 오류 메시지를 가져옵니다.
nameAvailable

boolean

이름을 사용할 수 있는지 여부를 나타내는 부울 값을 가져옵니다. true이면 이름을 사용할 수 있습니다. false이면 이름이 이미 사용되었습니다.
reason

Reason

Video Indexer 계정 이름을 사용할 수 없는 이유를 가져옵니다. Reason 요소는 NameAvailable이 false인 경우에만 반환됩니다.

ErrorDefinition

오류 정의.

Name 형식 Description
code

string

HTTP 오류 코드의 하위 상태 역할을 하는 서비스별 오류 코드입니다.
details

ErrorDefinition[]

내부 오류 세부 정보입니다.
message

string

오류 설명입니다.

ErrorResponse

오류 응답입니다.

Name 형식 Description
error

ErrorDefinition

오류 세부 정보입니다.

Reason

Video Indexer 계정 이름을 사용할 수 없는 이유를 가져옵니다. Reason 요소는 NameAvailable이 false인 경우에만 반환됩니다.

Name 형식 Description
AlreadyExists

string

Type

리소스 유형인 Microsoft.VideoIndexer/accounts

Name 형식 Description
Microsoft.VideoIndexer/accounts

string