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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar, chame esta operação no OpenAPI Explorer. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeKeyVersion	Operação a ser executada. Defina o valor como DescribeKeyVersion.
KeyId	String	Sim	key-hzz630494463ejqjx\\\\	ID, alias ou Alibaba Cloud Resource Name (ARN) da chave. Para mais informações, consulte Gerenciar um alias de chave. Nota Para acessar uma chave em outra conta Alibaba Cloud, use o ARN da chave. O formato do ARN é `acs:kms:${region}:${account}:key/${keyid}`.
KeyVersionId	String	Sim	2ab1a983-7072-4bbc-a582-584b5bd8\\\\	ID da versão da chave. Este identificador deve ser globalmente único. Para obter os IDs de versão de uma chave, chame ListKeyVersions.

Para mais informações sobre parâmetros comuns de requisição, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	7021b6ec-4be7-4d3c-8a68-1e85d4d515a0	ID da requisição, usado para localizar e solucionar problemas.
KeyVersion	Object		Metadados da versão da chave.
KeyId	String	key-hzz630494463ejqjx\\\\	ID da chave. Se o KeyId na requisição for definido como o alias ou o ARN da chave, o sistema retornará o ID real da chave.
KeyVersionId	String	2ab1a983-7072-4bbc-a582-584b5bd8\\\\	ID da versão da chave. Este identificador é globalmente único.
CreationDate	String	2024-03-25T10:42:40Z	Data e hora de criação da versão da chave. O horário é exibido em UTC.

Exemplos

Exemplo de requisição

http(s)://[Endpoint]/?Action=DescribeKeyVersion
&KeyId=key-hzz630494463ejqjx****
&KeyVersionId=2ab1a983-7072-4bbc-a582-584b5bd8****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeKeyVersionResponse>
    <RequestId>7021b6ec-4be7-4d3c-8a68-1e85d4d515a0</RequestId>
    <KeyVersion>
        <KeyId>key-hzz630494463ejqjx****</KeyId>
        <KeyVersionId>2ab1a983-7072-4bbc-a582-584b5bd8****</KeyVersionId>
        <CreationDate>2024-03-25T10:42:40Z</CreationDate>
    </KeyVersion>
</DescribeKeyVersionResponse>

Formato JSON

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

{
  "RequestId": "7021b6ec-4be7-4d3c-8a68-1e85d4d515a0",
  "KeyVersion": {
    "KeyId": "key-hzz630494463ejqjx****",
    "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
    "CreationDate": "2024-03-25T10:42:40Z"
  }
}

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.

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