Subscription - Create Or Update
Vytvoří nebo aktualizuje předplatné zadaného uživatele na zadaný produkt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}?api-version=2022-08-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}?notify={notify}&api-version=2022-08-01&appType={appType}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
service
|
path | True |
string |
Název služby API Management. Regex pattern: |
sid
|
path | True |
string |
Identifikátor entity předplatného. Entita představuje přidružení mezi uživatelem a produktem v API Management. Regex pattern: |
subscription
|
path | True |
string |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
app
|
query |
Určuje typ aplikace, která odesílá žádost uživatele o vytvoření. Výchozí je starší verze portálu vydavatele. |
||
notify
|
query |
boolean |
Upozornit na změnu stavu předplatného.
|
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
If-Match |
string |
Značka ETag entity. Nevyžaduje se při vytváření entity, ale vyžaduje se při aktualizaci entity. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.displayName | True |
string |
Název předplatného. |
properties.scope | True |
string |
Rozsah, jako je /products/{productId} nebo /apis nebo /apis/{apiId}. |
properties.allowTracing |
boolean |
Určuje, jestli je možné povolit trasování. |
|
properties.ownerId |
string |
Uživatel (cesta id uživatele), pro kterého se vytváří předplatné ve formátu /users/{userId} |
|
properties.primaryKey |
string |
Primární klíč předplatného. Pokud není klíč požadavku zadán, vygeneruje se automaticky. |
|
properties.secondaryKey |
string |
Sekundární klíč předplatného. Pokud není klíč požadavku zadán, vygeneruje se automaticky. |
|
properties.state |
Počáteční stav předplatného. Pokud není zadána žádná hodnota, vytvoří se předplatné se stavem Odesláno. Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a předplatitel nemůže volat žádná rozhraní API produktu, * odesláno – žádost o předplatné byla podána vývojářem, ale ještě nebyla schválena nebo zamítnuta, * zamítnuta – žádost o předplatné byla zamítnuta správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Uživatel se již přihlásil k odběru produktu. Headers ETag: string |
|
201 Created |
Uživatel se úspěšně přihlásil k odběru produktu. Headers ETag: string |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
ApiManagementCreateSubscription
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/testsub?api-version=2022-08-01
{
"properties": {
"ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
"scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
"displayName": "testsub"
}
}
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/testsub",
"type": "Microsoft.ApiManagement/service/subscriptions",
"name": "testsub",
"properties": {
"ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
"scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
"displayName": "testsub",
"state": "submitted",
"createdDate": "2017-06-02T23:34:03.1055076Z"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/subscriptions/testsub",
"type": "Microsoft.ApiManagement/service/subscriptions",
"name": "testsub",
"properties": {
"ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57127d485157a511ace86ae7",
"scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
"displayName": "testsub",
"state": "submitted",
"createdDate": "2017-06-02T23:34:03.1055076Z"
}
}
Definice
Name | Description |
---|---|
App |
Určuje typ aplikace, která odesílá žádost uživatele o vytvoření. Výchozí je starší verze portálu vydavatele. |
Error |
Chyba Kontrakt pole. |
Error |
Odpověď na chybu. |
Subscription |
Podrobnosti o předplatném. |
Subscription |
Podrobnosti o vytvoření předplatného |
Subscription |
Stav předplatného. Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a předplatitel nemůže volat žádná rozhraní API produktu, * odesláno – žádost o předplatné byla podána vývojářem, ale ještě nebyla schválena nebo zamítnuta, * zamítnuta – žádost o předplatné byla zamítnuta správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno. |
AppType
Určuje typ aplikace, která odesílá žádost uživatele o vytvoření. Výchozí je starší verze portálu vydavatele.
Name | Typ | Description |
---|---|---|
developerPortal |
string |
Žádost o vytvoření uživatele byla odeslána novým portálem pro vývojáře. |
portal |
string |
Starší verze portálu pro vývojáře odeslala žádost o vytvoření uživatele. |
ErrorFieldContract
Chyba Kontrakt pole.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby na úrovni vlastnosti. |
message |
string |
Čitelné znázornění chyby na úrovni vlastností. |
target |
string |
Název vlastnosti. |
ErrorResponse
Odpověď na chybu.
Name | Typ | Description |
---|---|---|
error.code |
string |
Kód chyby definované službou Tento kód slouží jako dílčí stav pro kód chyby HTTP zadaný v odpovědi. |
error.details |
Seznam neplatných polí se odešle v žádosti v případě chyby ověření. |
|
error.message |
string |
Znázornění chyby čitelné pro člověka |
SubscriptionContract
Podrobnosti o předplatném.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku. 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 |
Datum vytvoření předplatného. Datum odpovídá následujícímu formátu: |
properties.displayName |
string |
Název předplatného nebo null, pokud předplatné nemá žádný název. |
properties.endDate |
string |
Datum zrušení nebo vypršení platnosti předplatného Toto nastavení je jenom pro účely auditu a předplatné se nezruší automaticky. Životní cyklus předplatného je možné spravovat pomocí |
properties.expirationDate |
string |
Datum vypršení platnosti předplatného. Nastavení je jenom pro účely auditu a předplatné automaticky nevypršelo. Životní cyklus předplatného je možné spravovat pomocí |
properties.notificationDate |
string |
Nadcházející datum oznámení o vypršení platnosti předplatného Datum odpovídá následujícímu formátu: |
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 |
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, jako je /products/{productId} nebo /apis nebo /apis/{apiId}. |
properties.secondaryKey |
string |
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 |
Datum aktivace předplatného. Toto nastavení je jenom pro účely auditu a předplatné se neaktivuje automaticky. Životní cyklus předplatného je možné spravovat pomocí |
properties.state |
Stav předplatného. Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a předplatitel nemůže volat žádná rozhraní API produktu, * odesláno – žádost o předplatné byla podána vývojářem, ale ještě nebyla schválena nebo zamítnuta, * zamítnuta – žádost o předplatné byla zamítnuta správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela – 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ítnuto. |
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
SubscriptionCreateParameters
Podrobnosti o vytvoření předplatného
Name | Typ | Description |
---|---|---|
properties.allowTracing |
boolean |
Určuje, jestli je možné povolit trasování. |
properties.displayName |
string |
Název předplatného. |
properties.ownerId |
string |
Uživatel (cesta id uživatele), pro kterého se vytváří předplatné ve formátu /users/{userId} |
properties.primaryKey |
string |
Primární klíč předplatného. Pokud není klíč požadavku zadán, vygeneruje se automaticky. |
properties.scope |
string |
Rozsah, jako je /products/{productId} nebo /apis nebo /apis/{apiId}. |
properties.secondaryKey |
string |
Sekundární klíč předplatného. Pokud není klíč požadavku zadán, vygeneruje se automaticky. |
properties.state |
Počáteční stav předplatného. Pokud není zadána žádná hodnota, vytvoří se předplatné se stavem Odesláno. Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a předplatitel nemůže volat žádná rozhraní API produktu, * odesláno – žádost o předplatné byla podána vývojářem, ale ještě nebyla schválena nebo zamítnuta, * zamítnuta – žádost o předplatné byla zamítnuta správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno. |
SubscriptionState
Stav předplatného. Možné stavy jsou * aktivní – předplatné je aktivní, * pozastaveno – předplatné je zablokované a předplatitel nemůže volat žádná rozhraní API produktu, * odesláno – žádost o předplatné byla podána vývojářem, ale ještě nebyla schválena nebo zamítnuta, * zamítnuta – žádost o předplatné byla zamítnuta správcem, * zrušena – předplatné bylo zrušeno vývojářem nebo správcem, * Vypršela – předplatné dosáhlo data vypršení platnosti a bylo deaktivováno.
Name | Typ | Description |
---|---|---|
active |
string |
|
cancelled |
string |
|
expired |
string |
|
rejected |
string |
|
submitted |
string |
|
suspended |
string |