User Subscription - Get

Služba:: API Management

Verze rozhraní API:: 2024-05-01

Získá zadanou entitu předplatného přidruženou k určitému uživateli.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/subscriptions/{sid}?api-version=2024-05-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	Název služby API Management.
sid	path	True	string maxLength: 256 pattern: ^[^*#&+:<>?]+$	Identifikátor entity předplatného Entita představuje přidružení mezi uživatelem a produktem ve službě API Management.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
userId	path	True	string minLength: 1 maxLength: 80	Identifikátor uživatele. V aktuální instanci služby API Management musí být jedinečné.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	SubscriptionContract	Tělo odpovědi obsahuje zadanou entitu předplatného. Hlavičky ETag: string
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Name

Typ

Description

200 OK

SubscriptionContract

Tělo odpovědi obsahuje zadanou entitu předplatného.

Hlavičky

ETag: string

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ApiManagementGetUserSubscription

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1/subscriptions/5fa9b096f3df14003c070001?api-version=2024-05-01

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1/subscriptions/5fa9b096f3df14003c070001",
  "type": "Microsoft.ApiManagement/service/users/subscriptions",
  "name": "5fa9b096f3df14003c070001",
  "properties": {
    "ownerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/1",
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/starter",
    "state": "active",
    "createdDate": "2020-11-09T21:11:50.58Z",
    "allowTracing": true
  }
}

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
SubscriptionContract	Podrobnosti předplatného
SubscriptionState	Stav předplatného Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a odběratel nemůže volat žádná rozhraní API produktu, * odeslat – žádost o předplatné odeslal vývojář, ale ještě nebyla schválena nebo odmítnuta, * odmítnuta – žádost o předplatné byl zamítnut správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela platnost – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

SubscriptionContract

Objekt

Podrobnosti předplatného

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.allowTracing	boolean	Určuje, jestli je povolené trasování.
properties.createdDate	string (date-time)	Datum vytvoření předplatného Datum odpovídá následujícímu formátu: `yyyy-MM-ddTHH:mm:ssZ` podle normy ISO 8601.
properties.displayName	string minLength: 0 maxLength: 100	Název předplatného nebo hodnota null, pokud předplatné nemá žádné jméno.
properties.endDate	string (date-time)	Datum zrušení předplatného nebo vypršení jeho platnosti Nastavení je určené jenom pro účely auditu a předplatné se automaticky nezruší. Životní cyklus předplatného je možné spravovat pomocí vlastnosti `state`. Datum odpovídá následujícímu formátu: `yyyy-MM-ddTHH:mm:ssZ` podle normy ISO 8601.
properties.expirationDate	string (date-time)	Datum vypršení platnosti předplatného Nastavení je určené jenom pro účely auditu a předplatné nevypršelo automaticky. Životní cyklus předplatného je možné spravovat pomocí vlastnosti `state`. Datum odpovídá následujícímu formátu: `yyyy-MM-ddTHH:mm:ssZ` podle normy ISO 8601.
properties.notificationDate	string (date-time)	Nadcházející datum oznámení o vypršení platnosti předplatného Datum odpovídá následujícímu formátu: `yyyy-MM-ddTHH:mm:ssZ` podle normy ISO 8601.
properties.ownerId	string	Identifikátor prostředku uživatele vlastníka předplatného. Hodnota je platná relativní adresa URL ve formátu /users/{userId}, kde {userId} je identifikátor uživatele.
properties.primaryKey	string minLength: 1 maxLength: 256	Primární klíč předplatného. Tato vlastnost nebude vyplněna při operacích GET. K získání hodnoty použijte požadavek POST /listSecrets.
properties.scope	string	Rozsah, například /products/{productId} nebo /apis nebo /apis/{apiId}.
properties.secondaryKey	string minLength: 1 maxLength: 256	Sekundární klíč předplatného Tato vlastnost nebude vyplněna při operacích GET. K získání hodnoty použijte požadavek POST /listSecrets.
properties.startDate	string (date-time)	Datum aktivace předplatného. Nastavení je určené jenom pro účely auditu a předplatné se neaktivuje automaticky. Životní cyklus předplatného je možné spravovat pomocí vlastnosti `state`. Datum odpovídá následujícímu formátu: `yyyy-MM-ddTHH:mm:ssZ` podle normy ISO 8601.
properties.state	SubscriptionState	Stav předplatného Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a odběratel nemůže volat žádná rozhraní API produktu, * odeslat – žádost o předplatné odeslal vývojář, ale ještě nebyla schválena nebo odmítnuta, * odmítnuta – žádost o předplatné byl zamítnut správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela platnost – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno.
properties.stateComment	string	Volitelný komentář k předplatnému přidaný správcem, když se stav změní na odmítnutý.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

SubscriptionState

Výčet

Stav předplatného Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a odběratel nemůže volat žádná rozhraní API produktu, * odeslat – žádost o předplatné odeslal vývojář, ale ještě nebyla schválena nebo odmítnuta, * odmítnuta – žádost o předplatné byl zamítnut správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela platnost – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno.

Hodnota	Description
suspended
active
expired
submitted
rejected
cancelled

Sdílet prostřednictvím

User Subscription - Get

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ApiManagementGetUserSubscription

Ukázkový požadavek

Ukázková odpověď

Definice

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SubscriptionContract

SubscriptionState