Gateway - Generate Token
Mendapatkan Token Otorisasi Akses Bersama untuk gateway.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/generateToken?api-version=2022-08-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
gateway
|
path | True |
string |
Pengidentifikasi entitas gateway. Harus unik dalam instans layanan API Management saat ini. Tidak boleh memiliki nilai 'terkelola' |
resource
|
path | True |
string |
Nama grup sumber daya. Nama tidak peka huruf besar/kecil. |
service
|
path | True |
string |
Nama layanan API Management. Regex pattern: |
subscription
|
path | True |
string |
ID langganan target. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
expiry | True |
string |
Waktu Kedaluwarsa Token. Waktu kedaluwarsa token maksimum diatur ke 30 hari. Tanggal sesuai dengan format berikut: |
keyType | True |
Kunci yang akan digunakan untuk menghasilkan token gateway. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Isi respons berisi token otorisasi untuk gateway. |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
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=="
}
Definisi
Nama | Deskripsi |
---|---|
Error |
Kontrak Bidang Kesalahan. |
Error |
Respons Kesalahan. |
Gateway |
Token akses gateway. |
Gateway |
Properti kontrak permintaan token gateway. |
Key |
Kunci sedang diregenerasi. |
ErrorFieldContract
Kontrak Bidang Kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan tingkat properti. |
message |
string |
Representasi kesalahan tingkat properti yang dapat dibaca manusia. |
target |
string |
Nama properti. |
ErrorResponse
Respons Kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
error.code |
string |
Kode kesalahan yang ditentukan layanan. Kode ini berfungsi sebagai sub-status untuk kode kesalahan HTTP yang ditentukan dalam respons. |
error.details |
Daftar bidang yang tidak valid dikirim dalam permintaan, jika terjadi kesalahan validasi. |
|
error.message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
GatewayTokenContract
Token akses gateway.
Nama | Jenis | Deskripsi |
---|---|---|
value |
string |
Nilai token Autentikasi Akses Bersama untuk Gateway. |
GatewayTokenRequestContract
Properti kontrak permintaan token gateway.
Nama | Jenis | Nilai Default | Deskripsi |
---|---|---|---|
expiry |
string |
Waktu Kedaluwarsa Token. Waktu kedaluwarsa token maksimum diatur ke 30 hari. Tanggal sesuai dengan format berikut: |
|
keyType | primary |
Kunci yang akan digunakan untuk menghasilkan token gateway. |
KeyType
Kunci sedang diregenerasi.
Nama | Jenis | Deskripsi |
---|---|---|
primary |
string |
|
secondary |
string |