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

Observações de uso

Após registrar um servidor externo como instância gerenciada da Alibaba Cloud com um código de ativação, você pode usar diversos serviços online na instância, como Cloud Assistant, CloudOps Orchestration Service (OOS) e Apsara Devops.

Para registrar um servidor não fornecido pela Alibaba Cloud como instância gerenciada, o servidor deve ter conectividade com a internet e executar uma das seguintes versões de sistema operacional:

Alibaba Cloud Linux 2, Alibaba Cloud Linux 3 e posteriores
CentOS 6, CentOS 7, CentOS 8 e posteriores
Debian 8, Debian 9, Debian 10 e posteriores
Ubuntu 12, Ubuntu 14, Ubuntu 16, Ubuntu 18 e posteriores
CoreOS
OpenSUSE
Red Hat 5, Red Hat 6, Red Hat 7 e posteriores
SUSE Linux Enterprise Server (SLES) 11, SLES 12, SLES 15 e posteriores
Windows Server 2012, Windows Server 2016, Windows Server 2019 e posteriores

É permitido ter até 5.000 códigos de ativação por região da Alibaba Cloud. Se a quantidade de códigos ultrapassar 1.000, a taxa de utilização deve ser superior a 50% para que seja possível criar novos códigos.

Nota

Para consultar a utilização dos códigos de ativação, acesse a página

Cloud Assistant

no console do Elastic Compute Service (ECS), clique em

Manage Instances

e, em seguida, clique em

Register Instance

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateActivation	A operação a ser executada. Defina o valor como CreateActivation.
RegionId	String	Sim	cn-hangzhou	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 de regiões mais recente.
InstanceName	String	Não	test-InstanceName	Prefixo padrão do nome da instância. Deve ter entre 2 e 50 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Aceita letras, dígitos, pontos (.), sublinhados (_), hifens (-) e dois-pontos (:). Ao usar o código de ativação criado pela operação CreateActivation para registrar instâncias gerenciadas, elas recebem nomes sequenciais com o valor deste parâmetro como prefixo. Também é possível especificar um novo nome para substituir o nome sequencial atribuído durante o registro. Se você especificar InstanceName ao registrar uma instância gerenciada, um nome será gerado no formato `<InstanceName>-<Número>`. A quantidade de dígitos em <Número> varia conforme o número de dígitos do valor de `InstanceCount`. Exemplo: `001`. Caso não especifique InstanceName, o hostname será usado como nome da instância.
Description	String	Não	This is description.	Descrição do código de ativação. Deve ter entre 1 e 100 caracteres.
InstanceCount	Integer	Não	10	Número máximo de vezes que o código de ativação pode ser usado para registrar instâncias gerenciadas. Valores válidos: 1 a 1000. Valor padrão: 10.
TimeToLiveInHours	Long	Não	4	Período de validade do código de ativação. Após o término desse prazo, o código não poderá mais ser usado para registrar instâncias. Unidade: horas. Valores válidos: 1 a 876576. Isso representa um intervalo de tempo de 1 hora a 100 anos. Valor padrão: 4.
IpAddressRange	String	Não	0.0.0.0/0	Endereços IP dos hosts autorizados a usar o código de ativação. O valor pode incluir endereços IPv4, IPv6 ou blocos CIDR.
ResourceGroupId	String	Não	rg-123******	ID do grupo de recursos ao qual o código de ativação pertence.
Tag.N.Key	String	Não	TestKey	Chave da tag N a ser adicionada ao código de ativação. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Ao especificar uma única tag para consultar recursos, até 1.000 recursos associados a essa tag podem ser retornados. Se múltiplas tags forem definidas, o retorno inclui até 1.000 recursos que possuam todas as tags especificadas. Para consultar mais de 1.000 recursos com as tags indicadas, chame a operação ListTagResources. A chave da tag pode ter até 64 caracteres e não deve conter `http://` ou `https://`. Além disso, não pode começar com `acs:` ou `aliyun`.
Tag.N.Value	String	Não	TestValue	Valor da tag N a ser adicionado ao 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 aceita até 128 caracteres e não pode conter `http://` ou `https://`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	ID da solicitação.
ActivationCode	String	a-hz0ch3SwhOlE1234+Xo32lAZC****	Valor do código de ativação. Este valor é retornado apenas uma vez após a chamada da operação CreateActivation. Salve-o adequadamente.
ActivationId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	ID do código de ativação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=CreateActivation
&InstanceName=test-InstanceName
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateActivationResponse>
    <RequestId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</RequestId>
    <ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</ActivationId>
    <ActivationCode>a-hz0ch3SwhOlE1234+Xo32lAZC****</ActivationCode>
</CreateActivationResponse>

Formato JSON

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

{
  "RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "ActivationCode" : "a-hz0ch3SwhOlE1234+Xo32lAZC****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	RegionId.ApiNotSupported	The api is not supported in this region.	A operação não pode ser chamada na região especificada. Verifique se o ID da região é válido.
400	InstanceName.ExceedLimit	Default instance name prefix length exceeds.	O comprimento máximo do prefixo do nome da instância foi excedido.
400	InstanceName.InvalidPattern	Default instance name prefix pattern invalid.	Valor de InstanceName inválido.
400	ActivationDesc.ExceedLimit	Activation description length exceeds.	O comprimento máximo da descrição do código de ativação foi excedido.
400	ActivationLimitation.Invalid	Registration limitation must be positive.	O número máximo de usos do código de ativação para registrar instâncias gerenciadas foi excedido.
400	AddressRange.InvalidPattern	Address range should be ipv4 address or cidr.	Os endereços IP dos hosts autorizados a usar o código devem ser IPv4, IPv6 ou blocos CIDR.
400	ActivationCount.ExceedLimit	Too many activations have been created.	O número máximo de códigos de ativação que podem ser criados foi excedido.
400	ActivationTTL.ExceedLimit	Activation TTL exceeds limit.	Valor de TimeToLiveInHours 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.	O número máximo de tags foi excedido.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key é obrigatório.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves devem ser únicas.
403	Operation.Forbidden	The operation is not permitted.	A operação não é suportada.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.	Não é possível executar esta operação em um grupo de recursos que está sendo criado ou excluído.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Grupo de recursos não encontrado.
500	InternalError.Dispatch	An error occurred when dispatch the request.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.

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