Scheduled Actions - Check Name Availability

참조

서비스:: Cost Management

API 버전:: 2023-11-01

예약된 작업의 이름 가용성 및 정확성을 확인합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
name	string	가용성을 확인해야 하는 리소스의 이름입니다.
type	string	리소스 종류입니다.

응답

Name	형식	Description
200 OK	CheckNameAvailabilityResponse	예약된 작업 이름 가용성에 대한 응답입니다.
Other Status Codes	ErrorResponseWithNestedDetails	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

ScheduledActionCheckNameAvailability

샘플 요청

HTTP

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

{
  "name": "testName",
  "type": "Microsoft.CostManagement/ScheduledActions"
}

샘플 응답

상태 코드:: 200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "A private scheduled action with name 'testName' is already present. Please specify a differnt name."
}

정의

Name	Description
CheckNameAvailabilityReason	지정된 이름을 사용할 수 없는 이유입니다.
CheckNameAvailabilityRequest	검사 가용성 요청 본문입니다.
CheckNameAvailabilityResponse	검사 가용성 결과입니다.
ErrorDetailsWithNestedDetails	오류의 세부 정보입니다.
ErrorResponseWithNestedDetails	오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.

CheckNameAvailabilityReason

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

Name	형식	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

검사 가용성 요청 본문입니다.

Name	형식	Description
name	string	가용성을 확인해야 하는 리소스의 이름입니다.
type	string	리소스 종류입니다.

CheckNameAvailabilityResponse

검사 가용성 결과입니다.

Name	형식	Description
message	string	지정된 이름을 사용할 수 있는 자세한 이유입니다.
nameAvailable	boolean	리소스 이름을 사용할 수 있는지를 나타냅니다.
reason	CheckNameAvailabilityReason	지정된 이름을 사용할 수 없는 이유입니다.

ErrorDetailsWithNestedDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
details	ErrorDetailsWithNestedDetails[]	오류의 추가 세부 정보입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponseWithNestedDetails

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetailsWithNestedDetails	오류의 세부 정보입니다.

다음을 통해 공유