Freigeben über


Communication Services - Create Or Update

Erstellen oder Aktualisieren
Erstellen Sie einen neuen CommunicationService, oder aktualisieren Sie einen vorhandenen CommunicationService.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}?api-version=2023-03-31

URI-Parameter

Name In Erforderlich Typ Beschreibung
communicationServiceName
path True

string

Der Name der CommunicationService-Ressource.

Regex pattern: ^[-\w]+$

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

uuid

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet

properties.dataLocation True

string

Der Speicherort, an dem der Kommunikationsdienst ruhende Daten speichert.

properties.linkedDomains

string[]

Liste der E-Mail-Domänenressourcen-ID.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

CommunicationServiceResource

Die Erstellungs- oder Aktualisierungsanforderung wurde erfolgreich abgeschlossen.

201 Created

CommunicationServiceResource

Die Erstellungs- oder Aktualisierungsanforderung wurde akzeptiert.

Headers

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Beispiele

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"
  }
}

Definitionen

Name Beschreibung
CommunicationServiceResource

Eine Klasse, die eine CommunicationService-Ressource darstellt.

CommunicationServices_ProvisioningState

Bereitstellungsstatus der Ressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

CommunicationServiceResource

Eine Klasse, die eine CommunicationService-Ressource darstellt.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.dataLocation

string

Der Speicherort, an dem der Kommunikationsdienst ruhende Daten speichert.

properties.hostName

string

FQDN des CommunicationService-instance.

properties.immutableResourceId

string

Die unveränderliche Ressourcen-ID des Kommunikationsdiensts.

properties.linkedDomains

string[]

Liste der E-Mail-Domänenressourcen-ID.

properties.notificationHubId

string

Ressourcen-ID einer Azure Notification Hub-Instanz, die mit dieser Ressource verknüpft ist.

properties.provisioningState

CommunicationServices_ProvisioningState

Bereitstellungsstatus der Ressource.

properties.version

string

Version der CommunicationService-Ressource. Wahrscheinlich benötigen Sie dieselbe oder eine höhere Version von Client-SDKs.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

CommunicationServices_ProvisioningState

Bereitstellungsstatus der Ressource.

Name Typ Beschreibung
Canceled

string

Creating

string

Deleting

string

Failed

string

Moving

string

Running

string

Succeeded

string

Unknown

string

Updating

string

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.