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

Cria um código de ativação (código dinâmico) que é usado para registrar um servidor que não seja do Elastic Compute Service como uma instância gerenciada do Alibaba Cloud.

Descrição da operação

Após registrar um servidor que não seja do Elastic Compute Service como uma instância gerenciada do Alibaba Cloud usando um código de ativação (código dinâmico), você pode usar vários serviços online fornecidos pelo Alibaba Cloud, como Cloud Assistant, gerenciamento de operações e Apsara DevOps, na instância gerenciada.

O sistema operacional do servidor não Alibaba Cloud deve atender aos seguintes requisitos de versão, e o servidor deve ter acesso à Internet antes de poder ser registrado como uma instância gerenciada do Alibaba Cloud.

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

Em uma região do Alibaba Cloud, você pode ter até 10 códigos de ativação para instâncias gerenciadas. Um único código de ativação pode ser usado para ativar até 10 instâncias, e o período de validade máximo de um único código de ativação é de 4 horas.

Nota

Você pode acessar a guia Instâncias Gerenciadas na página Cloud Assistant e clicar em Registrar Nova Instância para obter o código de ativação (código dinâmico) e seus dados de uso.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:CreateActivation

create

*Activation

acs:ecs:{#regionId}:{#accountId}:activation/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da regiã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), Hong Kong (China), Cingapura, Japão (Tóquio), EUA (Vale do Silício) e EUA (Virgínia). Você pode invocar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceName	string	Não	O prefixo padrão do nome da instância. O prefixo deve ter de 2 a 50 caracteres. Deve começar com uma letra e não pode começar com um caractere especial ou um dígito. Pode conter apenas pontos (.), sublinhados (_), hifens (-) e dois-pontos (:). Não pode começar com `http://` ou `https://`. As instâncias registradas usando o código de ativação criado por esta operação usam este nome como prefixo para gerar nomes de instância sequenciais. Você também pode especificar um novo nome de instância para substituir este valor padrão ao registrar uma instância gerenciada. Ao registrar uma instância gerenciada, se você especificar o parâmetro InstanceName, um nome de instância no formato -001 será gerado. O número de dígitos no número de série 001 depende do número de dígitos no valor do parâmetro InstanceCount. Se você não especificar o parâmetro InstanceName, o nome do host do host será usado como o nome da instância.	test-InstanceName
Description	string	Não	A descrição do código de ativação. A descrição deve ter de 1 a 100 caracteres.	This is description.
InstanceCount	integer	Não	O 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.	10
TimeToLiveInHours	integer	Não	O período de validade do código de ativação. Após a expiração do código de ativação, ele não pode ser usado para registrar novas instâncias. Unidade: horas. Valores válidos: 1 a 4. Valor padrão: 4.	4
IpAddressRange	string	Não	Os endereços IP dos hosts que têm permissão para usar o código de ativação. Defina o valor como um endereço IPv4, um endereço IPv6 ou um bloco CIDR.	0.0.0.0/0
ClientToken	string	Não	O token de cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O parâmetro ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o código de ativação pertence.	rg-123******
Tag	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag N do código de ativação da instância gerenciada (código dinâmico). Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia. Se você usar uma única tag para filtrar recursos, a contagem de recursos retornada não poderá exceder 1.000. Se você usar várias tags para filtrar recursos, a contagem de recursos anexados a todas as tags especificadas não poderá exceder 1.000. Se a contagem de recursos exceder 1.000, você deverá invocar a operação ListTagResources para consultar os recursos. A chave da tag pode ter até 64 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	TestKey
Value	string	Não	O valor da tag N do código de ativação da instância gerenciada. 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://`.	TestValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	4ECEEE12-56F1-4FBC-9AB1-890F1234****
ActivationCode	string	O código de ativação. O código é retornado apenas uma vez quando a operação é chamada e não pode ser consultado posteriormente. Certifique-se de armazenar com segurança o valor de retorno.	a-hz0ch3SwhOlE1234+Xo32lAZC****
ActivationId	string	O ID do código de ativação.	4ECEEE12-56F1-4FBC-9AB1-890F1234****

Exemplos

Resposta de sucesso

JSON formato

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

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.	Esta operação de API não é suportada na região especificada. Verifique se o valor do parâmetro RegionId está correto.
400	InstanceName.ExceedLimit	Default instance name prefix length exceeds.	O comprimento do prefixo do nome da instância excede o limite máximo.
400	InstanceName.InvalidPattern	Default instance name prefix pattern invalid.	O prefixo do nome da instância é inválido.
400	ActivationDesc.ExceedLimit	Activation description length exceeds.	O comprimento da descrição do código de ativação excede o limite superior.
400	ActivationLimitation.Invalid	The specified parameter InstanceCount exceeds the limit of %s.	O número de vezes que o código de ativação pode ser usado para registrar instâncias gerenciadas excede o limite.
400	AddressRange.InvalidPattern	Address range should be ipv4 address or cidr.	Os endereços IP de host permitidos para usar o código de ativação devem ser endereços IPv4 válidos, endereços IPv6 ou blocos CIDR.
400	ActivationCount.ExceedLimit	The count of activation in current region exceeds the limit of %s.	O número de códigos de ativação que podem ser criados excede o limite superior.
400	ActivationTTL.ExceedLimit	The specified parameter TimeToLiveInHours exceeds the limit of %s.	O período de validade do código de ativação excede o limite.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	O parâmetro de chave de tag especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	O parâmetro de valor da tag especificado está incorreto.
400	NumberExceed.Tags	The Tags parameter number is exceed.	O número de tags excede o limite máximo. Esta operação suporta no máximo 20 tags.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Especifique uma chave de tag.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Certifique-se de que as chaves sejam exclusivas.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	O parâmetro de idempotência especificado é inválido.
500	InternalError.Dispatch	An error occurred when dispatch the request.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	Operation.Forbidden	The operation is not permitted.	A operação não é permitida.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.	Esta operação não é permitida enquanto um grupo de recursos está sendo criado ou excluído.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Sua conta Alibaba Cloud não concluiu a verificação de nome real. Conclua a verificação e tente novamente.
403	ManagedInstanceCountExceedLimit	The count of managed instance in current region exceeds the limit of %s.	O número de instâncias gerenciadas na região atual excede o limite de %s.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Os parâmetros da solicitação não correspondem aos de uma solicitação anterior com o mesmo ClientToken.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Uma solicitação idempotente anterior ainda está sendo processada. Tente novamente mais tarde.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o serviço está disponível na região.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.