Gateway - Generate Token
Ruft das SAS-Autorisierungstoken für das Gateway ab.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/generateToken?api-version=2022-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
gateway
|
path | True |
string |
Gatewayentitätsbezeichner. Muss im aktuellen API Management-Dienst instance eindeutig sein. Darf nicht über den Wert "managed" verfügen. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
service
|
path | True |
string |
Der Name des API Management-Diensts. Regex pattern: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
expiry | True |
string |
Die Ablaufzeit des Tokens. Die maximale Tokenablaufzeit ist auf 30 Tage festgelegt. Das Datum entspricht dem folgenden Format: |
keyType | True |
Der Schlüssel, der zum Generieren des Gatewaytokens verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Antworttext enthält das Autorisierungstoken für das Gateway. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
ApiManagementGatewayGenerateToken
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/generateToken?api-version=2022-08-01
{
"keyType": "primary",
"expiry": "2020-04-21T00:44:24.2845269Z"
}
Sample Response
{
"value": "gw1&201904210044&9A1GR1f5WIhFvFmzQG+xxxxxxxxxxx/kBeu87DWad3tkasUXuvPL+MgzlwUHyg=="
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Fehler Feldvertrag. |
Error |
Fehlerantwort. |
Gateway |
Gatewayzugriffstoken. |
Gateway |
Eigenschaften des Gatewaytokenanforderungsvertrags. |
Key |
Der Schlüssel, der neu generiert wird. |
ErrorFieldContract
Fehler Feldvertrag.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode auf Eigenschaftsebene. |
message |
string |
Für Menschen lesbare Darstellung eines Fehlers auf Eigenschaftsebene. |
target |
string |
Der Eigenschaftsname. |
ErrorResponse
Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error.code |
string |
Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode. |
error.details |
Die Liste der ungültigen Felder, die in der Anforderung gesendet werden, im Falle eines Validierungsfehlers. |
|
error.message |
string |
Lesbare Darstellung des Fehlers. |
GatewayTokenContract
Gatewayzugriffstoken.
Name | Typ | Beschreibung |
---|---|---|
value |
string |
Wert des Shared Access Authentication-Tokens für das Gateway. |
GatewayTokenRequestContract
Eigenschaften des Gatewaytokenanforderungsvertrags.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
expiry |
string |
Die Ablaufzeit des Tokens. Die maximale Tokenablaufzeit ist auf 30 Tage festgelegt. Das Datum entspricht dem folgenden Format: |
|
keyType | primary |
Der Schlüssel, der zum Generieren des Gatewaytokens verwendet werden soll. |
KeyType
Der Schlüssel, der neu generiert wird.
Name | Typ | Beschreibung |
---|---|---|
primary |
string |
|
secondary |
string |