Todos os produtos
Search
Central de documentação

Key Management Service:GetSecretPolicy

Última atualização: Jun 28, 2026

Consulta a política de acesso de um segredo especificado em uma instância KMS.

Descrição da operação

  • Para obter informações sobre a política de acesso necessária para que um usuário RAM ou uma função RAM chame esta OpenAPI, consulte Resource Access Management.

  • O nome de uma política de credencial pode ser definido apenas como default. Portanto, você deve definir o parâmetro PolicyName como default ao consultar a política de credencial. Caso contrário, um erro Not Found será retornado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SecretName

string

Sim

O nome ou o Alibaba Cloud Resource Name (ARN) da credencial.

Nota

Se você acessar uma credencial que pertence a outra conta da Alibaba Cloud, deverá especificar o ARN da credencial. O ARN de uma credencial deve estar no formato acs:kms:${region}:${account}:secret/${secret-name}.

secret_test

PolicyName

string

Não

O nome da política de credencial. Somente o campo estático default é suportado.

default

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação. Este ID é um identificador único gerado pela Alibaba Cloud para a solicitação. Você pode usar o ID para solucionar problemas e localizar falhas.

381D5D33-BB8F-395F-8EE4-AE3BB4B523C8

Policy

string

A política de credencial.

{"Version":"1","Statement": [{"Sid":"kms default secret policy","Effect":"Allow","Principal":{"RAM": ["acs:ram::119285303511****:*"]},"Action":["kms:*"],"Resource": ["*"] }] }

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "381D5D33-BB8F-395F-8EE4-AE3BB4B523C8",
  "Policy": "{\"Version\":\"1\",\"Statement\": [{\"Sid\":\"kms default secret policy\",\"Effect\":\"Allow\",\"Principal\":{\"RAM\": [\"acs:ram::119285303511****:*\"]},\"Action\":[\"kms:*\"],\"Resource\": [\"*\"] }] }"
}

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. An invalid value is specified for the parameter.
400 MissingParameter The parameter needed but no provided. The required parameters are not specified.
400 Forbidden.NoPermission This operation is forbidden by permission system. You are not authorized to perform this operation.
400 Forbidden.KeyPolicyUnSupported The specified key does not support key policy. The specified key does not support key policies.
403 Forbidden.DKMSInstanceStateInvalid The DKMS instance state is invalid. Your dedicated KMS instance is invalid.
404 Forbidden.ResourceNotFound Resource not found. The resource is not found.
404 Forbidden.KeyNotFound The specified Key is not found. The error message returned because the specified CMK does not exist.
503 SerivceUnvailableTemporary Service Unvailable Temporary The service is temporarily unavailable.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.