Phone Numbers - Get Operation

Service:

Communication

Version d'API:

2025-02-11

Obtient une opération par son ID.

GET {endpoint}/phoneNumbers/operations/{operationId}?api-version=2025-02-11

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string url	Ressource de communication, par exemple https://resourcename.communication.azure.com
operationId	path	True	string	ID de l’opération
api-version	query	True	string	Version de l’API à appeler

Réponses

Nom	Type	Description
200 OK	PhoneNumberOperation	Une fois l’opération terminée, interrogez le résultat final de l’opération à l’aide de l’URL spécifiée dans l’attribut « Location » dans l’en-tête de réponse. En-têtes Location: string
Other Status Codes	CommunicationErrorResponse	Échec

Exemples

Get long running operation status by operation id

Exemple de requête

HTTP

GET https://resourcename.communication.azure.com//phoneNumbers/operations/search-my-operation-id?api-version=2025-02-11

Exemple de réponse

Code d’état:

200

Location: /availablePhoneNumbers/searchResults/378ddf60-81be-452a-ba4f-613198ea6c28

{
  "status": "succeeded",
  "resourceLocation": "/availablePhoneNumbers/searchResults/378ddf60-81be-452a-ba4f-613198ea6c28",
  "createdDateTime": "2020-11-19T16:31:49.048Z",
  "id": "search-my-operation-id",
  "operationType": "search",
  "lastActionDateTime": "2020-11-19T22:31:49.048Z"
}

Définitions

Nom	Description
CommunicationError	Erreur Communication Services.
CommunicationErrorResponse	Erreur Communication Services.
PhoneNumberOperation
PhoneNumberOperationStatus	État de l’opération.
PhoneNumberOperationType	Type d’opération, par exemple Recherche

CommunicationError

Object

Erreur Communication Services.

Nom	Type	Description
code	string	Code d’erreur.
details	CommunicationError[]	Plus d’informations sur les erreurs spécifiques qui ont conduit à cette erreur.
innererror	CommunicationError	Erreur interne le cas échéant.
message	string	Message d’erreur.
target	string	Cible d’erreur.

CommunicationErrorResponse

Object

Erreur Communication Services.

Nom	Type	Description
error	CommunicationError	Erreur Communication Services.

PhoneNumberOperation

Object

Nom	Type	Description
createdDateTime	string	Date de création de l’opération.
error	CommunicationError	Erreur Communication Services.
id	string	ID de l’opération.
lastActionDateTime	string	Date la plus récente à laquelle l’opération a été modifiée.
operationType	PhoneNumberOperationType	Type d’opération, par exemple Recherche
resourceLocation	string	URL pour récupérer le résultat de l’opération, le cas échéant.
status	PhoneNumberOperationStatus	État de l’opération.

PhoneNumberOperationStatus

Enumeration

État de l’opération.

Valeur	Description
failed
notStarted
running
succeeded

PhoneNumberOperationType

Enumeration

Type d’opération, par exemple Recherche

Valeur	Description
purchase
releasePhoneNumber
search
updatePhoneNumberCapabilities