共用方式為


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 參數

名稱 位於 必要 類型 Description
communicationServiceName
path True

string

CommunicationService 資源的名稱。

Regex 模式: ^[-\w]+$

resourceGroupName
path True

string

資源群組的名稱。 名稱不區分大小寫。

subscriptionId
path True

string

uuid

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

要用於這項作業的 API 版本。

要求本文

名稱 類型 Description
keyType

KeyType

要重新產生的keyType。 必須是 'primary' 或 'secondary'(不區分大小寫)。

回應

名稱 類型 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"
}

定義

名稱 Description
CommunicationServiceKeys

類別,表示 CommunicationService 的存取密鑰。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

KeyType

要重新產生的keyType。 必須是 'primary' 或 'secondary'(不區分大小寫)。

RegenerateKeyParameters

參數描述重新產生存取密鑰的要求

CommunicationServiceKeys

類別,表示 CommunicationService 的存取密鑰。

名稱 類型 Description
primaryConnectionString

string

透過 primaryKey 建構的 CommunicationService 連接字串

primaryKey

string

主要存取金鑰。

secondaryConnectionString

string

透過 secondaryKey 建構的 CommunicationService 連接字串

secondaryKey

string

次要存取金鑰。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細數據。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

KeyType

要重新產生的keyType。 必須是 'primary' 或 'secondary'(不區分大小寫)。

名稱 類型 Description
Primary

string

Secondary

string

RegenerateKeyParameters

參數描述重新產生存取密鑰的要求

名稱 類型 Description
keyType

KeyType

要重新產生的keyType。 必須是 'primary' 或 'secondary'(不區分大小寫)。