Policy - Create Or Update
Cria ou atualiza a configuração de política global do serviço de Gerenciamento de API.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/policy?api-version=2022-08-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
policy
|
path | True |
O identificador da Política. |
|
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. Padrão Regex: |
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. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
If-Match |
string |
ETag da Entidade. Não é necessário ao criar uma entidade, mas necessário ao atualizar uma entidade. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
properties.value | True |
string |
Conteúdo da Política conforme definido pelo formato. |
properties.format |
Formato da policyContent. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
A configuração de política global do serviço de Gerenciamento de API foi atualizada com êxito. Cabeçalhos ETag: string |
|
201 Created |
A configuração de política global foi criada com êxito. Cabeçalhos ETag: string |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
ApiManagementCreatePolicy
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy?api-version=2022-08-01
{
"properties": {
"format": "xml",
"value": "<policies>\r\n <inbound />\r\n <backend>\r\n <forward-request />\r\n </backend>\r\n <outbound />\r\n</policies>"
}
}
Resposta de exemplo
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
"type": "Microsoft.ApiManagement/service/policies",
"name": "policy",
"properties": {
"value": "<policies>\r\n <inbound />\r\n <backend>\r\n <forward-request />\r\n </backend>\r\n <outbound />\r\n</policies>"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policies/policy",
"type": "Microsoft.ApiManagement/service/policies",
"name": "policy",
"properties": {
"value": "<policies>\r\n <inbound />\r\n <backend>\r\n <forward-request />\r\n </backend>\r\n <outbound />\r\n</policies>"
}
}
Definições
Nome | Description |
---|---|
Error |
Contrato de Campo de Erro. |
Error |
Resposta de erro. |
Policy |
Formato da policyContent. |
Policy |
Detalhes do contrato de política. |
Policy |
O identificador da Política. |
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. |
PolicyContentFormat
Formato da policyContent.
Nome | Tipo | Description |
---|---|---|
rawxml |
string |
O conteúdo está embutido e o Tipo de conteúdo é um documento de política não codificado em XML. |
rawxml-link |
string |
O documento de política não é codificado em XML e está hospedado em um ponto de extremidade HTTP acessível pelo serviço Gerenciamento de API. |
xml |
string |
O conteúdo está embutido e o Tipo de conteúdo é um documento XML. |
xml-link |
string |
O documento XML de política é hospedado em um ponto de extremidade HTTP acessível do serviço Gerenciamento de API. |
PolicyContract
Detalhes do contrato de política.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
name |
string |
O nome do recurso |
|
properties.format | xml |
Formato da policyContent. |
|
properties.value |
string |
Conteúdo da Política conforme definido pelo formato. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
PolicyIdName
O identificador da Política.
Nome | Tipo | Description |
---|---|---|
policy |
string |