Teams Requests For Information - Get Request For Information

Référence

Service:: Voice Services

Version d'API:: 2024-02-29-preview

Obtenir une demande d’informations.
Obtenez les détails d’une demande spécifique d’informations à l’aide de son ID.

GET https:///teamsRequestsForInformation/{tenantId}?api-version=2024-02-29-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
tenantId	path	True	string minLength: 1 maxLength: 36 pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	ID de locataire Teams qui a généré cette demande d’informations.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Type	Description
If-Match	string	La requête ne doit continuer que si une entité correspond à cette chaîne.
If-None-Match	string	La requête ne doit continuer que si aucune entité ne correspond à cette chaîne.
If-Unmodified-Since	string (date-time)	La requête ne doit continuer que si l’entité n’a pas été modifiée après cette période.
If-Modified-Since	string (date-time)	La requête ne doit continuer que si l’entité a été modifiée après cette période.
x-ms-client-request-id	string (uuid)	Identificateur de chaîne opaque, globalement unique et généré par le client pour la requête.

Réponses

Nom	Type	Description
200 OK	RequestForInformationResource	La demande a réussi. En-têtes ETag: string x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

RequestForInformationResource

La demande a réussi.

En-têtes

ETag: string
x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: application
URL du jeton: https://login.microsoftonline.com/common/oauth2/v2.0/token

Étendues

Nom	Description
https://func-voiceservice-rp-prod-eastuseuap.azurewebsites.net/.default

Exemples

Get an RFI by tenant ID.

Exemple de requête

HTTP

GET https:///teamsRequestsForInformation/a7f4bd5c-cc01-40f4-8baa-2b6bdb272b8a?api-version=2024-02-29-preview

Exemple de réponse

Code d’état:: 200

{
  "id": "214b3a0e-fb7c-481f-9f38-fcb7eab5fad3",
  "tenantId": "a7f4bd5c-cc01-40f4-8baa-2b6bdb272b8a",
  "accountName": "contoso",
  "productContext": "teams",
  "operatorId": "75f9fed4-d8e9-4c90-bc28-523cfdb83244",
  "status": "active",
  "consentedOn": "2024-01-18T07:58:49.570Z",
  "lastModifiedOn": "2024-01-18T07:58:49.570Z",
  "consentedCountries": [
    "US",
    "UK"
  ],
  "contacts": [
    {
      "fullName": "John Smith",
      "email": "johnsmith@commsgw.operator.com",
      "telephoneNumber": "+15105850321",
      "companyName": "operator",
      "companySize": "L1_U1"
    }
  ],
  "customerRelationship": {
    "status": "ConsentAcknowledged",
    "lastModifiedOn": "2024-01-18T07:58:49.570Z",
    "comment": "Acknowledged"
  },
  "serviceProvisioningStatus": "synced",
  "serviceProvisioningErrors": []
}

Définitions

Nom	Description
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
ContactDetails	Coordonnées d’un individu.
CustomerRelationship	Détails d’une relation client.
RequestForInformationResource	Configuration d’un numéro de téléphone approvisionné dans ACG.
ServiceProvisioningStatus	États d’approvisionnement d’un objet sur n’importe quel service back-end approprié.
TeamsConsentStatus	État possible d’un consentement d’opérateur.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

ContactDetails

Object

Coordonnées d’un individu.

Nom	Type	Description
companyName	string	Nom de la société du détail du contact.
companySize	string	Taille de l’entreprise des détails du contact.
email	string minLength: 1	E-mail des détails du contact.
fullName	string minLength: 1	Nom complet du détail du contact.
telephoneNumber	string	Numéro de téléphone des détails du contact.

CustomerRelationship

Object

Détails d’une relation client.

Nom	Type	Description
comment	string	Commentaire de la relation client.
lastModifiedOn	string (date-time)	Heure (format ISO8601) de la dernière modification de la relation client.
status	string	État de la relation client.

RequestForInformationResource

Object

Configuration d’un numéro de téléphone approvisionné dans ACG.

Nom	Type	Description
accountName	string	Nom du compte associé à cette demande d’informations.
consentedCountries	string[]	Liste des pays acceptés.
consentedOn	string (date-time)	Heure (format ISO8601) lors de la création du consentement de l’opérateur.
contacts	ContactDetails[]	Liste des contacts du locataire.
customerRelationship	CustomerRelationship	Relation client du consentement de l’opérateur.
id	string	ID de la demande d’informations.
lastModifiedOn	string (date-time)	Heure (format ISO8601) de la dernière modification de l’opérateur.
operatorId	string	ID d’opérateur du consentement de l’opérateur.
productContext	string	Sera toujours « teams ».
serviceProvisioningErrors	Azure.Core.Foundations.Error[]	Toutes les erreurs relatives à l’approvisionnement de cette ressource.
serviceProvisioningStatus	ServiceProvisioningStatus	État de l’action d’approvisionnement associée à cette ressource.
status	TeamsConsentStatus	État du consentement de l’opérateur.
tenantId	string minLength: 1 maxLength: 36 pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	ID de locataire Teams qui a généré cette demande d’informations.

ServiceProvisioningStatus

Énumération

États d’approvisionnement d’un objet sur n’importe quel service back-end approprié.

Valeur	Description
failed	L’opération d’approvisionnement d’objets a échoué avec le service principal approprié.
pending	L’objet est en attente d’approvisionnement.
synced	L’objet a été synchronisé avec le service principal approprié.

TeamsConsentStatus

Énumération

État possible d’un consentement d’opérateur.

Valeur	Description
active	Le consentement de l’opérateur est actif.
removed	Le consentement de l’opérateur est supprimé.
suspended	Le consentement de l’opérateur est suspendu.

Partager via

Teams Requests For Information - Get Request For Information

Paramètres URI

En-tête de la demande

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

Get an RFI by tenant ID.

Exemple de requête

Exemple de réponse

Définitions

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ContactDetails

CustomerRelationship

RequestForInformationResource

ServiceProvisioningStatus

TeamsConsentStatus