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

Observações de uso

Use um dos métodos a seguir para verificar as respostas:

Método 1: Ao chamar a operação DescribeActivations para obter a primeira página de resultados em uma consulta paginada, use MaxResults para especificar o número máximo de entradas retornadas na chamada. O valor retornado de NextToken é um token de paginação. Use-o na próxima solicitação para recuperar uma nova página de resultados. Para obter essa nova página ao chamar a operação DescribeActivations, defina NextToken com o valor retornado na chamada anterior e use MaxResults para indicar o limite de entradas desta chamada.
Método 2: Use PageSize para definir a quantidade de entradas por página e PageNumber para indicar qual página retornar. Use apenas um desses métodos por vez. Se você especificar MaxResults ou NextToken, os parâmetros de solicitação PageSize e PageNumber não terão efeito e o parâmetro de resposta TotalCount será inválido.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeActivations	A operação a ser executada. Defina o valor como DescribeActivations.
RegionId	String	Sim	cn-hangzhou	O ID da região do código de ativação. Regiões suportadas: China (Qingdao), China (Pequim), China (Zhangjiakou), China (Hohhot), China (Ulanqab), China (Hangzhou), China (Xangai), China (Shenzhen), China (Heyuan), China (Guangzhou), China (Chengdu), China (Hong Kong), Singapura, Japão (Tóquio), EUA (Vale do Silício) e EUA (Virgínia). Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
ActivationId	String	Não	4ECEEE12-56F1-4FBC-9AB1-890F1234****	O ID do código de ativação.
InstanceName	String	Não	test-InstanceName	O prefixo padrão do nome da instância.
PageNumber	Long	Não	1	O número da página. A numeração das páginas começa em 1. Valor padrão: 1.
PageSize	Long	Não	10	A quantidade de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10.
MaxResults	Integer	Não	10	O número máximo de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10.
NextToken	String	Não	AAAAAdDWBF2****	Token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Não especifique este parâmetro na primeira solicitação. Defina o token obtido na consulta anterior como valor de NextToken.
ResourceGroupId	String	Não	rg-123	O ID do grupo de recursos ao qual o código de ativação pertence.
Tag.N.Key	String	Não	TestKey	A chave da tag N do código de ativação. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Se você especificar uma única tag para consultar recursos, o sistema poderá retornar até 1.000 recursos com essa tag. Se especificar várias tags, o retorno poderá incluir até 1.000 recursos que contenham todas elas. Para consultar mais de 1.000 recursos associados às tags especificadas, chame a operação ListTagResources. A chave da tag pode ter até 64 caracteres e não pode conter `http://` ou `https://`. Além disso, não pode começar com `acs:` ou `aliyun`.
Tag.N.Value	String	Não	TestValue	O valor da tag N do código de ativação. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Long	10	A quantidade de entradas por página.
RequestId	String	4ECEEE12-56F1-4FBC-9AB1-890F74625134	O ID da solicitação.
PageNumber	Long	1	O número da página.
TotalCount	Long	1	O número total de entradas retornadas.
NextToken	String	AAAAAdDWBF2****	Token de paginação. Use-o na próxima solicitação para recuperar uma nova página de resultados.
ActivationList	Array of Activation		Os códigos de ativação e respectivas informações de uso.
CreationTime	String	2021-01-20T06:00:00Z	A hora de criação do código de ativação.
DeregisteredCount	Integer	1	A quantidade de instâncias canceladas.
InstanceCount	Integer	1	O número máximo de vezes que você pode usar o código de ativação para registrar instâncias gerenciadas.
Description	String	This is description.	A descrição do código de ativação.
RegisteredCount	Integer	1	A quantidade de instâncias registradas.
InstanceName	String	test-InstanceName	O prefixo padrão do nome da instância.
Disabled	Boolean	false	Indica se o código de ativação está desativado.
IpAddressRange	String	0.0.0.0/0	Os endereços IP dos hosts que podem usar o código de ativação.
TimeToLiveInHours	Long	4	O período de validade do código de ativação. Unidade: horas.
ActivationId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	O ID do código de ativação.
ResourceGroupId	String	rg-123	O ID do grupo de recursos ao qual o código de ativação pertence.
Tags	Array of Tag		As tags do código de ativação.
TagKey	String	owner	A chave da tag do código de ativação.
TagValue	String	zhangsan	O valor da tag do código de ativação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeActivations
&RegionId=cn-hangzhou
&ActivationId=4ECEEE12-56F1-4FBC-9AB1-890F1234****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeActivationsResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>4ECEEE12-56F1-4FBC-9AB1-890F74942176</RequestId>
    <PageNumber>1</PageNumber>
    <ActivationList>
        <InstanceName>test-InstanceName</InstanceName>
        <DeregisteredCount>1</DeregisteredCount>
        <InstanceCount>1</InstanceCount>
        <Description>This is description.</Description>
        <CreationTime>2021-01-20T06:00:00Z</CreationTime>
        <ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</ActivationId>
        <RegisteredCount>1</RegisteredCount>
        <TimeToLiveInHours>4</TimeToLiveInHours>
        <Disabled>false</Disabled>
        <IpAddressRange>0.0.0.0/0</IpAddressRange>
    </ActivationList>
</DescribeActivationsResponse>

Formato JSON

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

{
  "TotalCount" : "1",
  "PageSize" : "10",
  "RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F74942176",
  "PageNumber" : "1",
  "ActivationList" : [ {
    "InstanceName" : "test-InstanceName",
    "DeregisteredCount" : "1",
    "InstanceCount" : "1",
    "Description" : "This is description.",
    "CreationTime" : "2021-01-20T06:00:00Z",
    "ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
    "RegisteredCount" : "1",
    "TimeToLiveInHours" : "4",
    "Disabled" : "false",
    "IpAddressRange" : "0.0.0.0/0"
  } ]
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	RegionId.ApiNotSupported	The api is not supported in this region.	Esta operação não pode ser executada na região especificada. Verifique se o valor de RegionId é válido.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valor de PageNumber inválido.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valor de PageSize inválido.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value inválido.
400	NumberExceed.Tags	The Tags parameter number is exceed.	A quantidade de tags excede o limite superior.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key é obrigatório.
400	InvalidParameter.NextToken	The specified parameter NextToken is not valid.	Valor de NextToken inválido.
400	InvalidParameter.MaxResults	The specified parameter MaxResults is not valid.	Valor de MaxResults inválido.
403	Operation.Forbidden	The operation is not permitted.	A operação não é suportada.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocorreu um erro durante o envio da solicitação. Tente novamente mais tarde.

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