User - Get Shared Access Token
Obtient le jeton d’autorisation d’accès partagé pour l’utilisateur.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/token?api-version=2024-05-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
service
|
path | True |
string minLength: 1maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$ |
Nom du service Gestion des API. |
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
user
|
path | True |
string minLength: 1maxLength: 80 |
Identificateur de l’utilisateur. Doit être unique dans l’instance actuelle du service Gestion des API. |
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties.expiry | True |
string (date-time) |
Heure d’expiration du jeton. La durée d’expiration maximale du jeton est définie sur 30 jours. La date est conforme au format suivant : |
properties.keyType | True |
Clé à utiliser pour générer un jeton pour l’utilisateur. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Le corps de la réponse contient le jeton d’autorisation de l’utilisateur. |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
ApiManagementUserToken
Exemple de requête
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/userId1718/token?api-version=2024-05-01
{
"properties": {
"keyType": "primary",
"expiry": "2019-04-21T00:44:24.2845269Z"
}
}
Exemple de réponse
{
"value": "userId1718&201904210044&9A1GR1f5WIhFvFmzQG+xxxxxxxxxxx/kBeu87DWad3tkasUXuvPL+MgzlwUHyg=="
}
Définitions
Nom | Description |
---|---|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Key |
Clé à utiliser pour générer un jeton pour l’utilisateur. |
User |
Obtenir les paramètres du jeton utilisateur. |
User |
Obtenir les détails de la réponse du jeton utilisateur. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires. |
type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
KeyType
Clé à utiliser pour générer un jeton pour l’utilisateur.
Valeur | Description |
---|---|
primary | |
secondary |
UserTokenParameters
Obtenir les paramètres du jeton utilisateur.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
properties.expiry |
string (date-time) |
Heure d’expiration du jeton. La durée d’expiration maximale du jeton est définie sur 30 jours. La date est conforme au format suivant : |
|
properties.keyType | primary |
Clé à utiliser pour générer un jeton pour l’utilisateur. |
UserTokenResult
Obtenir les détails de la réponse du jeton utilisateur.
Nom | Type | Description |
---|---|---|
value |
string |
Jeton d’autorisation d’accès partagé pour l’utilisateur. |