Communication Services - Create Or Update
Создание или обновление
Создайте службу коммуникации или обновите существующую.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}?api-version=2023-03-31
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
communication
|
path | True |
string |
Имя ресурса CommunicationService. Regex pattern: |
resource
|
path | True |
string |
Имя группы ресурсов. Регистр букв в имени не учитывается. |
subscription
|
path | True |
string uuid |
Идентификатор целевой подписки. Значение должно быть UUID. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
location | True |
string |
Географическое расположение, в котором находится ресурс |
properties.dataLocation | True |
string |
Расположение, в котором служба связи хранит неактивные данные. |
properties.linkedDomains |
string[] |
Список идентификаторов ресурсов домена электронной почты. |
|
tags |
object |
Теги ресурсов. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Запрос на создание или обновление успешно завершен. |
|
201 Created |
Запрос на создание или обновление принят Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Примеры
Create or update resource
Sample Request
PUT https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/communicationServices/MyCommunicationResource?api-version=2023-03-31
{
"location": "Global",
"properties": {
"dataLocation": "United States"
}
}
Sample Response
{
"id": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
"name": "MyCommunicationResource",
"type": "Microsoft.Communication/CommunicationServices",
"location": "Global",
"properties": {
"dataLocation": "United States",
"provisioningState": "Succeeded",
"hostName": "mycommunicationresource.communications.azure.com"
}
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.Communication/locations/westus/operationStatuses/ed5d502c-acaa-42ec-ad61-0d8488a9fd1d
{
"id": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
"name": "MyCommunicationResource",
"type": "Microsoft.Communication/CommunicationServices",
"location": "Global",
"properties": {
"dataLocation": "United States",
"provisioningState": "Accepted"
}
}
Определения
Имя | Описание |
---|---|
Communication |
Класс, представляющий ресурс CommunicationService. |
Communication |
Состояние подготовки ресурса. |
created |
Тип удостоверения, создавшего ресурс. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
system |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
CommunicationServiceResource
Класс, представляющий ресурс CommunicationService.
Имя | Тип | Описание |
---|---|---|
id |
string |
Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Географическое расположение, в котором находится ресурс |
name |
string |
Имя ресурса. |
properties.dataLocation |
string |
Расположение, в котором служба связи хранит неактивные данные. |
properties.hostName |
string |
Полное доменное имя экземпляра CommunicationService. |
properties.immutableResourceId |
string |
Неизменяемый идентификатор ресурса службы связи. |
properties.linkedDomains |
string[] |
Список идентификаторов ресурсов домена электронной почты. |
properties.notificationHubId |
string |
Идентификатор ресурса центра уведомлений Azure, связанного с этим ресурсом. |
properties.provisioningState |
Состояние подготовки ресурса. |
|
properties.version |
string |
Версия ресурса CommunicationService. Возможно, вам нужна та же или более поздняя версия клиентских пакетов SDK. |
systemData |
Azure Resource Manager метаданные, содержащие сведения createdBy и modifiedBy. |
|
tags |
object |
Теги ресурсов. |
type |
string |
Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts. |
CommunicationServices_ProvisioningState
Состояние подготовки ресурса.
Имя | Тип | Описание |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
createdByType
Тип удостоверения, создавшего ресурс.
Имя | Тип | Описание |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |
systemData
Метаданные, относящиеся к созданию и последнему изменению ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Удостоверение, которое последним изменял ресурс. |
lastModifiedByType |
Тип удостоверения, которое последним изменял ресурс. |