Skip to main content
Astra Automation
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Obtenha uma licença

PDFs

GET /accounts/{account_id}/core/v1/licenses/{license_id}

Retorna o recurso da API de Licença armazenado no corpo da resposta JSON.

Parâmetros

Nome Tipo Em Obrigatório Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

  • exemplo: {{.Account}}

id_da_licença

string

caminho

Verdadeiro

ID da coleção de licenças a ser listada

Resposta

Status: 200, Returns the stored License API resource in the JSON response body.
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-license"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

id

string

Verdadeiro

Identificador globalmente único do recurso. Os valores definidos são:

  • Em conformidade com o esquema UUIDv4

alocação

string

Falso

String JSON contendo um ID que indica a que a licença está alocada. Presente somente quando a licença está alocada. Para licenças do Astra Control Center, este campo deve ser preenchido com o ID da conta e deve corresponder ao ID da conta especificado no URI POST. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID do host

string

Falso

String JSON contendo um identificador de host ao qual uma licença está vinculada. Presente apenas se a licença estiver vinculada a um host específico. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

ID de credenciais do dispositivo

string

Falso

String JSON contendo o identificador do deviceCredential associado à API de Credenciais. Presente apenas para licenças do Astra Data Store. Os valores definidos são:

  • Conforme o esquema de identificador Astra

isEvaluation

string

Verdadeiro

String JSON que indica se a licença é uma licença de avaliação. Os valores definidos são:

  • "true"

  • "false"

licenseProtocol

string

Verdadeiro

String JSON contendo o protocolo de licença extraído da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

licenseText

string

Verdadeiro

String JSON contendo uma representação codificada em base64 do JSON da licença, conforme obtido do sistema de licenciamento NetApp. Esta string deve ser fornecida na ordem original de bytes para permitir a verificação da assinatura. Os valores definidos são:

  • Está em conformidade com o esquema de dados codificados em base64

validFromTimestamp

string

Verdadeiro

String JSON contendo um registro de data e hora indicando quando a licença se torna válida. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

validUntilTimestamp

string

Verdadeiro

String JSON contendo um registro de data e hora indicando quando a licença deixa de ser válida. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

produto

string

Verdadeiro

String JSON contendo a string do produto extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

productVersion

string

Verdadeiro

String JSON contendo a string de versão extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

produtoSN

string

Verdadeiro

String JSON contendo a string do número de série extraída da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

características

string

Verdadeiro

String JSON contendo o valor do pacote extraído da licença. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

capacidade

string

Verdadeiro

String JSON contendo a capacidade extraída da licença.

capacity2

string

Verdadeiro

String JSON contendo a capacidade secundária extraída da licença.

complementos

array["complementos"]

Falso

Matriz JSON de objetos JSON contendo a lista de complementos da licença. Um complemento é uma alteração na licença que pode ocorrer em uma data futura.

metadados

"type_astra_metadados_update"

Verdadeiro

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Está em conformidade com o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.
Exemplo de resposta 
{
  "type": "application/astra-license",
  "version": "1.0",
  "id": "6db53b32-8417-5d3c-8ef0-552fc602c78f",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "hostID": "99132549-e0c2-4203-9d1e-598628b4ff9b",
  "isEvaluation": "false",
  "licenseProtocol": "ASTRASDS-ENT-SUBS",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9",
  "validFromTimestamp": "2020-08-06T00:00:00.000000Z",
  "validUntilTimestamp": "2021-08-06T00:00:00.000000Z",
  "product": "Astra Control Center",
  "productVersion": "1.0",
  "productSN": "320000046",
  "features": "ASTRA-ENT-STD",
  "capacity": "4000",
  "capacity2": "0",
  "addons": [
    {
      "startDate": "2020-08-06T00:00:00.000000Z",
      "endDate": "2021-08-06T00:00:00.000000Z",
      "capacity": "4000",
      "licenseProtocol": "ASTRA-ENT-STD",
      "features": "p-nfs,dm-storage-policy-based-pvs-for-k8s,dm-spbm-based-vvols-for-vms,dm-storage-efficiency,dm-data-at-rest-encryption"
    }
  ],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Resposta

Status: 401, Unauthorized
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Resposta

Status: 400, Bad request
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidParams

array["invalidParams"]

Falso

Lista de parâmetros de consulta inválidos
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Resposta

Status: 403, Forbidden
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Erro

Status: 404, Not found
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta de erro 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

complementos

Nome Tipo Obrigatório Descrição

startDate

string

Falso

String JSON contendo um carimbo de data/hora indicando quando este complemento se torna válido. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

endDate

string

Falso

String JSON contendo um carimbo de data/hora indicando quando este complemento deixa de ser válido. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

características

string

Falso

String JSON contendo a lista de funcionalidades associadas a este complemento. Os valores definidos são:

  • O conteúdo da string não foi validado pelo esquema.

capacidade

string

Falso

String JSON contendo a capacidade extraída do complemento. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

licenseProtocol

string

Falso

String JSON contendo o protocolo de licença associado a este complemento. Os valores definidos são:

  • Conteúdo da string não validado pelo esquema

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

type_astra_metadados_update

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Está em conformidade com o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

invalidParams

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do parâmetro de consulta inválido

razão

string

Verdadeiro

Motivo pelo qual o parâmetro de consulta é inválido