다음을 통해 공유


Communication Services - Regenerate Key

키 다시 생성
CommunicationService 액세스 키를 다시 생성합니다. PrimaryKey 및 SecondaryKey는 동시에 다시 생성할 수 없습니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}/regenerateKey?api-version=2023-04-01

URI 매개 변수

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

string

CommunicationService 리소스의 이름입니다.

regex 패턴: ^[-\w]+$

resourceGroupName
path True

string

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

subscriptionId
path True

string

uuid

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

api-version
query True

string

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

요청 본문

Name 형식 Description
keyType

KeyType

다시 생성할 keyType입니다. 'primary' 또는 'secondary'(대/소문자를 구분하지 않는)여야 합니다.

응답

Name 형식 Description
200 OK

CommunicationServiceKeys

키 다시 생성 요청이 성공적으로 완료되었습니다. 응답에는 새 키가 포함됩니다.

Other Status Codes

ErrorResponse

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

예제

Regenerate key

샘플 요청

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

{
  "keyType": "Primary"
}

샘플 응답

{
  "primaryKey": "1234",
  "primaryConnectionString": "endpoint=http://example.com;accesskey=1234"
}

정의

Name Description
CommunicationServiceKeys

CommunicationService의 액세스 키를 나타내는 클래스입니다.

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

KeyType

다시 생성할 keyType입니다. 'primary' 또는 'secondary'(대/소문자를 구분하지 않는)여야 합니다.

RegenerateKeyParameters

매개 변수는 액세스 키를 다시 생성하기 위한 요청을 설명합니다.

CommunicationServiceKeys

CommunicationService의 액세스 키를 나타내는 클래스입니다.

Name 형식 Description
primaryConnectionString

string

primaryKey를 통해 생성된 CommunicationService 연결 문자열

primaryKey

string

기본 액세스 키입니다.

secondaryConnectionString

string

secondaryKey를 통해 생성된 CommunicationService 연결 문자열

secondaryKey

string

보조 액세스 키입니다.

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

오류 개체입니다.

KeyType

다시 생성할 keyType입니다. 'primary' 또는 'secondary'(대/소문자를 구분하지 않는)여야 합니다.

Name 형식 Description
Primary

string

Secondary

string

RegenerateKeyParameters

매개 변수는 액세스 키를 다시 생성하기 위한 요청을 설명합니다.

Name 형식 Description
keyType

KeyType

다시 생성할 keyType입니다. 'primary' 또는 'secondary'(대/소문자를 구분하지 않는)여야 합니다.