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

Consulta as informações de licença atualmente em vigor para uma instância.

Descrição da operação

Certifique-se de que a instância não esteja mais em uso. Após a exclusão de uma instância EIAM, todos os dados relacionados são excluídos.

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

eiam:GetInstanceLicense

get

*Instance.

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	idaas_ue2jvisn35ea5lmthk2676xxxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0441BD79-92F3-53AA-8657-F8CE4A2B912A
License	object	O resultado retornado.
LicenseId	string	O identificador exclusivo da licença.	license_1234xxxx
LicenseStatus	string	O status da licença. Valores válidos: valid : Válido. expired : Expirado. released : Liberado.	valid
LicenseChargeType	string	O tipo de cobrança da licença. Valores válidos: prepay : Assinatura. postpay : Pós-pago.	prepay
LicenseConfigJson	string	A configuração detalhada da licença como uma string JSON.	{"modules":[{"features":[{"name":"urn:alibaba:idaas:license:module:ud:customField","status":"enabled"}]……{"name":"urn:alibaba:idaas:license:tag:enterprise","status":"enabled"}],"version":"1.0"}
LicenseCreateTime	integer	A hora de criação da licença, no formato de timestamp.	1720509699000
PurchaseChannel	string	O canal de compra da licença. Valores válidos: alibaba_cloud : Canal de vendas da Alibaba Cloud. system_free : Canal gratuito do sistema. system_trial : Canal de avaliação do sistema.	alibaba_cloud
PurchaseInstanceId	string	O identificador exclusivo do produto externo associado à licença.	eiam-cn-xxxxx
Edition	string	A edição da licença. Valores válidos: enterprise : Edição Enterprise. free : Edição gratuita. trial : Edição de avaliação.	free
UserQuota	integer	A cota de usuários da licença.	100
StartTime	integer	A data de início do período de validade da licença, no formato de timestamp.	1720509699000
EndTime	integer	A data de término do período de validade da licença, no formato de timestamp.	1723996800000
InstanceLicenseDetail	object	As informações detalhadas da licença da instância.
UserQuota	integer	A cota de usuários da licença.	100
PrepaidActiveUserNumber	integer	O número de usuários ativos pré-pagos.	100
M2mApplicationQuota	integer	A cota de aplicativos M2M da licença.	2
M2mApplicationLicenseStatus	string	O status da licença M2M. Valores válidos: disabled : Desativado. enabled : Ativado.	enabled
MimApplicationLicenseStatus	string	O status da licença de identidade de máquina.	enabled
PamLicenseStatus	string	O status da licença de gerenciamento de acesso privilegiado PAM. Valores válidos: disabled : Desativado. enabled : Ativado.	enabled
NetworkAccessEndpointQuota	integer	A cota de endpoints de acesso à rede da licença.	1
ConditionalAccessPolicyLicenseStatus	string	O status da licença de acesso condicional. Valores válidos: disabled : Desativado. enabled : Ativado.	enabled

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "License": {
    "LicenseId": "license_1234xxxx",
    "LicenseStatus": "valid",
    "LicenseChargeType": "prepay",
    "LicenseConfigJson": "{\"modules\":[{\"features\":[{\"name\":\"urn:alibaba:idaas:license:module:ud:customField\",\"status\":\"enabled\"}]……{\"name\":\"urn:alibaba:idaas:license:tag:enterprise\",\"status\":\"enabled\"}],\"version\":\"1.0\"}",
    "LicenseCreateTime": 1720509699000,
    "PurchaseChannel": "alibaba_cloud",
    "PurchaseInstanceId": "eiam-cn-xxxxx",
    "Edition": "free",
    "UserQuota": 100,
    "StartTime": 1720509699000,
    "EndTime": 1723996800000,
    "InstanceLicenseDetail": {
      "UserQuota": 100,
      "PrepaidActiveUserNumber": 100,
      "M2mApplicationQuota": 2,
      "M2mApplicationLicenseStatus": "enabled",
      "MimApplicationLicenseStatus": "enabled",
      "PamLicenseStatus": "enabled",
      "NetworkAccessEndpointQuota": 1,
      "ConditionalAccessPolicyLicenseStatus": "enabled"
    }
  }
}

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.