Gateway - Generate Token

Hizmet:: API Management

API Sürümü:: 2024-05-01

Ağ geçidi için Paylaşılan Erişim Yetkilendirme Belirtecini alır.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/generateToken?api-version=2024-05-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
gatewayId	path	True	string minLength: 1 maxLength: 80	Ağ geçidi varlık tanımlayıcısı. Geçerli API Management hizmet örneğinde benzersiz olmalıdır. 'Yönetilen' değerine sahip olmamalıdır
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	API Management hizmetinin adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
expiry	True	string (date-time)	Belirtecin Süre Sonu süresi. En fazla belirteç süre sonu süresi 30 gün olarak ayarlanır. Tarih şu biçime uygundur: ISO 8601 standardı tarafından belirtilen `yyyy-MM-ddTHH:mm:ssZ`.
keyType	True	KeyType	Ağ geçidi belirteci oluşturmak için kullanılacak anahtar.

Yanıtlar

Name	Tür	Description
200 OK	GatewayTokenContract	Yanıt gövdesi, ağ geçidi için yetkilendirme belirtecini içerir.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

ApiManagementGatewayGenerateToken

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/generateToken?api-version=2024-05-01

{
  "keyType": "primary",
  "expiry": "2020-04-21T00:44:24.2845269Z"
}

Örnek yanıt

Durum kodu:: 200

{
  "value": "gw1&201904210044&9A1GR1f5WIhFvFmzQG+xxxxxxxxxxx/kBeu87DWad3tkasUXuvPL+MgzlwUHyg=="
}

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
GatewayTokenContract	Ağ geçidi erişim belirteci.
GatewayTokenRequestContract	Ağ geçidi belirteci isteği sözleşme özellikleri.
KeyType	Anahtar yeniden oluşturuluyor.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

GatewayTokenContract

Object

Ağ geçidi erişim belirteci.

Name	Tür	Description
value	string	Ağ Geçidi için Paylaşılan Erişim Kimlik Doğrulaması belirteci değeri.

GatewayTokenRequestContract

Object

Ağ geçidi belirteci isteği sözleşme özellikleri.

Name	Tür	Default value	Description
expiry	string (date-time)		Belirtecin Süre Sonu süresi. En fazla belirteç süre sonu süresi 30 gün olarak ayarlanır. Tarih şu biçime uygundur: ISO 8601 standardı tarafından belirtilen `yyyy-MM-ddTHH:mm:ssZ`.
keyType	KeyType	primary	Ağ geçidi belirteci oluşturmak için kullanılacak anahtar.

KeyType

Listeleme

Anahtar yeniden oluşturuluyor.

Değer	Description
primary
secondary