Gateway - Generate Token
Obtém o token de autorização de acesso compartilhado para o gateway.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/generateToken?api-version=2022-08-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
gateway
|
path | True |
string |
Identificador de entidade de gateway. Deve ser exclusivo na instância de serviço Gerenciamento de API atual. Não deve ter o valor 'gerenciado' |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
service
|
path | True |
string |
O nome do serviço Gerenciamento de API. Regex pattern: |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
expiry | True |
string |
A hora de expiração do Token. O tempo máximo de expiração do token é definido como 30 dias. A data está em conformidade com o seguinte formato: |
keyType | True |
A Chave a ser usada para gerar o token de gateway. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
O corpo da resposta contém o token de autorização para o gateway. |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
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=="
}
Definições
Nome | Description |
---|---|
Error |
Contrato de campo de erro. |
Error |
Resposta de erro. |
Gateway |
Token de acesso de gateway. |
Gateway |
Propriedades do contrato de solicitação de token de gateway. |
Key |
A chave que está sendo regenerada. |
ErrorFieldContract
Contrato de campo de erro.
Nome | Tipo | Description |
---|---|---|
code |
string |
Código de erro no nível da propriedade. |
message |
string |
Representação legível por humanos do erro no nível da propriedade. |
target |
string |
Nome da propriedade. |
ErrorResponse
Resposta de erro.
Nome | Tipo | Description |
---|---|---|
error.code |
string |
Código de erro definido pelo serviço. Esse código atua como um substatus do código de erro HTTP especificado na resposta. |
error.details |
A lista de campos inválidos enviados na solicitação, em caso de erro de validação. |
|
error.message |
string |
Representação legível ao olho humano do erro. |
GatewayTokenContract
Token de acesso de gateway.
Nome | Tipo | Description |
---|---|---|
value |
string |
Valor do token de Autenticação de Acesso Compartilhado para o Gateway. |
GatewayTokenRequestContract
Propriedades do contrato de solicitação de token de gateway.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
expiry |
string |
A hora de expiração do Token. O tempo máximo de expiração do token é definido como 30 dias. A data está em conformidade com o seguinte formato: |
|
keyType | primary |
A Chave a ser usada para gerar o token de gateway. |
KeyType
A chave que está sendo regenerada.
Nome | Tipo | Description |
---|---|---|
primary |
string |
|
secondary |
string |