Todos os produtos
Search
Central de documentação

:UpdatePolicy

Última atualização: Jul 09, 2026

Atualiza uma política de permissões.

  • Você pode atualizar as permissões de controle de acesso baseado em função (RBAC), os recursos acessíveis, as regras de controle de acesso e a descrição de uma política de permissões. Não é possível alterar o nome ou o escopo da política.

  • A atualização de uma política de permissões afeta todos os pontos de acesso de aplicativo (AAPs) vinculados a ela. Tenha cuidado ao executar essa operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim UpdatePolicy

A operação a ser executada. Defina o valor como UpdatePolicy.

Name String Sim policy_test

O nome da política de permissões a ser atualizada.

Permissions String Não ["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]

As operações compatíveis com a política atualizada. Valores válidos:

  • RbacPermission/Template/CryptoServiceKeyUser: permite executar operações criptográficas.
  • RbacPermission/Template/CryptoServiceSecretUser: permite executar operações relacionadas a segredos.

Selecione ambas as opções.

Resources String Não ["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]

A chave e o segredo com acesso permitido após a atualização.

  • Chave: insira uma chave no formato key/${KeyId}. Para permitir acesso a todas as chaves de uma instância do KMS, insira key/*.
  • Segredo: insira um segredo no formato secret/${SecretName}. Para permitir acesso a todos os segredos de uma instância do KMS, insira secret/*.
AccessControlRules String Não {"NetworkRules":["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]}

A regra de controle de acesso.

Nota Para obter mais informações sobre como consultar regras de controle de acesso criadas, consulte ListNetworkRules.
Description String Não policy description

A descrição.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

f455324b-e229-4066-9f58-9c1cf3fe83a8

O ID da solicitação, usado para localizar e solucionar problemas.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdatePolicy
&Name=policy_test
&Permissions=["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]
&Resources=["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]
&AccessControlRules={"NetworkRules":["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]}
&Description=policy  description
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdatePolicyResponse>
    <RequestId>f455324b-e229-4066-9f58-9c1cf3fe83a8</RequestId>
</UpdatePolicyResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "f455324b-e229-4066-9f58-9c1cf3fe83a8"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidParameter

The specified parameter is not valid.

O parâmetro especificado é inválido.

404

InvalidAccessKeyId.NotFound

The Access Key ID provided does not exist in our records.

O AccessKey ID especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.