GenerateMac - Key Management Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Para obter detalhes sobre a política de acesso necessária quando um usuário RAM ou uma função RAM invoca esta operação, consulte o controle de acesso.

Esta operação pode ser invocada por meio de um gateway compartilhado ou um gateway dedicado. Para obter mais informações, consulte o SDK do Alibaba Cloud.

Gateway compartilhado: acesse o KMS por meio de um endpoint público ou de VPC. Este método exige que você ative a opção de acesso à rede pública. Para obter mais informações, consulte o acesso a chaves em uma instância do KMS pela Internet.
Gateway dedicado: acesse o KMS por meio de um endpoint privado do KMS (<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com).

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.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
KeyId	string	Sim	O ID da chave. Você também pode especificar um alias de chave ou um ARN (Amazon Resource Name) da chave. Para obter mais informações sobre aliases, consulte Gerenciar aliases de chave. Nota Ao acessar uma chave que pertence a uma conta diferente do Alibaba Cloud, você deve especificar o ARN da chave. O formato de um ARN de chave é `acs:kms:${region}:${account}:key/${keyid}`.	key-hzz630494463ejqjx****
Message	string	Sim	Os dados para os quais você deseja gerar um código de autenticação de mensagem. O valor é codificado em Base64. Por exemplo, se os dados hexadecimais forem `[0x31, 0x32, 0x33, 0x34]`, o valor correspondente codificado em Base64 será `MTIzNA==`.	VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4=
Algorithm	string	Sim	O algoritmo usado para gerar o código de autenticação de mensagem. Os valores válidos variam de acordo com a especificação da chave: HMAC_SM3 HMAC_SHA_224 HMAC_SHA_256 HMAC_SHA_384 HMAC_SHA_512	HMAC_SHA_256
DryRun	string	Não	Especifica se o modo DryRun deve ser ativado. true: ativado false (padrão): desativado O modo DryRun é usado para testar chamadas de API e verificar se você tem as permissões necessárias nos recursos correspondentes e se os parâmetros da solicitação estão configurados corretamente. Quando o modo DryRun está ativado, o KMS sempre retorna uma falha e fornece o motivo da falha. Os motivos de falha incluem: DryRunOperationError: a solicitação seria bem-sucedida sem o parâmetro DryRun. ValidationError: os parâmetros especificados na solicitação são inválidos. AccessDeniedError: você não está autorizado a realizar esta operação no recurso do KMS.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação. O Alibaba Cloud gera um identificador exclusivo para cada solicitação. Você pode usar este ID para solucionar problemas.	4c8ae23f-3a42-6791-a4ba-1faa77831c28
KeyId	string	O identificador globalmente exclusivo da chave mestra do cliente (CMK). Nota Se o parâmetro KeyId na solicitação usar um alias de CMK, a resposta retornará o identificador de CMK que corresponde ao alias.	key-hzz630494463ejqjx****
Algorithm	string	O algoritmo usado para gerar o código de autenticação de mensagem. Os valores válidos variam de acordo com a especificação da chave: HMAC_SM3 HMAC_SHA_224 HMAC_SHA_256 HMAC_SHA_384 HMAC_SHA_512	HMAC_SHA_256
Mac	string	O código de autenticação de mensagem codificado em Base64.	vz1Snp+jGJbgydCFRWVWxAwIMdyfKCSp+jnMWQ==

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4c8ae23f-3a42-6791-a4ba-1faa77831c28",
  "KeyId": "key-hzz630494463ejqjx****",
  "Algorithm": "HMAC_SHA_256",
  "Mac": "vz1Snp+jGJbgydCFRWVWxAwIMdyfKCSp+jnMWQ=="
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.