Communication Services - Create Or Update
Oluştur veya Güncelleştir
Yeni bir CommunicationService oluşturun veya mevcut CommunicationService'i güncelleştirin.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}?api-version=2023-03-31
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
communication
|
path | True |
string |
CommunicationService kaynağının adı. Normal ifade deseni: |
resource
|
path | True |
string |
Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir. |
subscription
|
path | True |
string uuid |
Hedef aboneliğin kimliği. Değer bir UUID olmalıdır. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
location | True |
string |
Kaynağın bulunduğu coğrafi konum |
properties.dataLocation | True |
string |
İletişim hizmetinin bekleyen verilerini depoladığı konum. |
properties.linkedDomains |
string[] |
E-posta Etki Alanı kaynak kimliklerinin listesi. |
|
tags |
object |
Kaynak etiketleri. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Oluşturma veya güncelleştirme isteği başarıyla tamamlandı |
|
201 Created |
Oluşturma veya güncelleştirme isteği kabul edildi Üst Bilgiler Azure-AsyncOperation: string |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Örnekler
Create or update resource
Örnek isteği
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"
}
}
Örnek yanıt
{
"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"
}
}
Tanımlar
Name | Description |
---|---|
Communication |
CommunicationService kaynağını temsil eden bir sınıf. |
Communication |
Kaynağın sağlama durumu. |
created |
Kaynağı oluşturan kimliğin türü. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
CommunicationServiceResource
CommunicationService kaynağını temsil eden bir sınıf.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Kaynağın bulunduğu coğrafi konum |
name |
string |
Kaynağın adı |
properties.dataLocation |
string |
İletişim hizmetinin bekleyen verilerini depoladığı konum. |
properties.hostName |
string |
CommunicationService örneğinin FQDN'sini seçin. |
properties.immutableResourceId |
string |
İletişim hizmetinin sabit kaynak kimliği. |
properties.linkedDomains |
string[] |
E-posta Etki Alanı kaynak kimliklerinin listesi. |
properties.notificationHubId |
string |
Bu kaynağa bağlı bir Azure Notification Hub'ın kaynak kimliği. |
properties.provisioningState |
Kaynağın sağlama durumu. |
|
properties.version |
string |
CommunicationService kaynağının sürümü. Büyük olasılıkla istemci SDK'larının aynı veya daha yüksek bir sürümüne ihtiyacınız vardır. |
systemData |
Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler. |
|
tags |
object |
Kaynak etiketleri. |
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
CommunicationServices_ProvisioningState
Kaynağın sağlama durumu.
Name | Tür | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağın son değişikliğinin zaman damgası (UTC) |
lastModifiedBy |
string |
Kaynağı son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimliğin türü. |