CreatePolicy - : Central de Documentação do Alibaba Cloud

Observações de uso

Para executar operações criptográficas e recuperar valores de segredo, aplicações autogerenciadas devem usar uma chave de cliente para acessar uma instância do Key Management Service (KMS). O processo a seguir mostra como criar um ponto de acesso à aplicação (AAP) baseado em chave de cliente:

Crie uma regra de controle de acesso: configure os endereços IP privados ou blocos CIDR privados com permissão para acessar uma instância do KMS. Para mais informações, consulte CreateNetworkRule.
Crie uma política de permissão: defina as chaves e os segredos com acesso permitido e vincule regras de controle de acesso a esses recursos.
Crie um AAP: especifique um método de autenticação e vincule uma política de permissão ao AAP. Para mais informações, consulte CreateApplicationAccessPoint.
Crie uma chave de cliente: configure a senha de criptografia e o período de validade da chave de cliente e vincule-a a um AAP. Para mais informações, consulte CreateClientKey.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreatePolicy	A operação a ser executada. Defina o valor como CreatePolicy.
Name	String	Sim	policy_test	Nome da política de permissão.
Description	String	Não	policy description	Descrição da política.
KmsInstance	String	Não	kst-hzz634e67d126u9p9****	Escopo da política de permissão. Especifique a instância do KMS a ser acessada.
Permissions	String	Sim	["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]	Operações permitidas. 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, se necessário.
Resources	String	Sim	["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]	Chaves e segredos com acesso permitido. 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	Map	Não	{"NetworkRules":["kst-hzz62ee817bvyyr5x**.efkd","kst-hzz62ee817bvyyr5x**.eyyp"]}	Nome da regra de controle de acesso. Nota Para consultar regras de controle de acesso criadas, consulte ListNetworkRules.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	3bf02f7a-015b-4f34-be0f-c4543fda2d33	ID da solicitação, usado para localizar e solucionar problemas.
Arn	String	acs:kms:cn-hangzhou:119285303511****:policy/policy_test	ARN da política de permissão.
Name	String	policy_test	Nome da política de permissão.
Description	String	policy description	Descrição da política.
KmsInstance	String	kst-hzz634e67d126u9p9****	Escopo da política de permissão.
Permissions	String	["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]	Operações permitidas.
Resources	String	["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]	Chaves e segredos com acesso permitido. `key/`: permite acesso a todas as chaves da instância do KMS. `secret/`: permite acesso a todos os segredos da instância do KMS.
AccessControlRules	String	{"NetworkRules":["kst-hzz62ee817bvyyr5x**.efkd","kst-hzz62ee817bvyyr5x**.eyyp"]}	Nome da regra de controle de acesso.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreatePolicy
&Name=policy_test
&Description=policy  description
&KmsInstance=kst-hzz634e67d126u9p9****
&Permissions=["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]
&Resources=["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreatePolicyResponse>
    <RequestId>3bf02f7a-015b-4f34-be0f-c4543fda2d33</RequestId>
    <Arn>acs:kms:cn-hangzhou:119285303511****:policy/policy_test</Arn>
    <Name>policy_test</Name>
    <Description>policy  description</Description>
    <KmsInstance>kst-hzz634e67d126u9p9****</KmsInstance>
    <Permissions>["RbacPermission/Template/CryptoServiceKeyUser", "RbacPermission/Template/CryptoServiceSecretUser"]</Permissions>
    <Resources>["secret/acs/ram/user/ram-secret", "secret/acs/ram/user/acr-master", "key/key-hzz63d9c8d3dfv8cv****"]</Resources>
    <AccessControlRules>{"NetworkRules":["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]}</AccessControlRules>
</CreatePolicyResponse>

Formato JSON

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

{
  "RequestId" : "3bf02f7a-015b-4f34-be0f-c4543fda2d33",
  "Arn" : "acs:kms:cn-hangzhou:119285303511****:policy/policy_test",
  "Name" : "policy_test",
  "Description" : "policy  description",
  "KmsInstance" : "kst-hzz634e67d126u9p9****",
  "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\"]}"
}

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.