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.

Modificar um backend de armazenamento

PDFs

PUT /accounts/{account_id}/topology/v1/storageBackends/{storageBackend_id}

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida, preservando os valores-chave que não podem ser modificados pelo usuário.

Efeitos Colaterais

  • Especificar uma versão de configuração resulta na aplicação de alterações de configuração específicas para o tipo de backend de armazenamento, o que pode incluir a instalação inicial de um backend de armazenamento.

  • Especificar uma versão de configuração pode resultar em recursos storageClass sendo adicionados, modificados ou removidos.

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}}

storageBackend_id

string

caminho

Verdadeiro

ID da coleção storageBackend a ser listada

Corpo da solicitação

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida, preservando os valores-chave que não podem ser modificados pelo usuário.

Efeitos Colaterais

  • Especificar uma versão de configuração resulta na aplicação de alterações de configuração específicas para o tipo de backend de armazenamento, o que pode incluir a instalação inicial de um backend de armazenamento.

  • Especificar uma versão de configuração pode resultar em recursos storageClass sendo adicionados, modificados ou removidos.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

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

  • "aplicação/astra-storageBackend"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

id

string

Falso

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

  • Em conformidade com o esquema UUIDv4

backendName

string

Falso

String JSON contendo um nome especificado pelo usuário para o backend de armazenamento. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

backendType

string

Falso

String JSON contendo um valor que indica o tipo de backend de armazenamento representado. Os valores definidos são:

  • "ontap" - O backend de armazenamento representa um NetApp ONTAP

  • enum: ["ontap"]

  • exemplo: ontap

backendVersion

string

Falso

String JSON contendo um valor que indica a versão do backend de armazenamento representado. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

backendCredentialsName

string

Falso

String JSON contendo um valor que indica o nome de um ou mais recursos de credencial usados para o backend de armazenamento. Permite a rotação de credencial quando vários objetos de credencial têm o mesmo nome. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

configVersion

string

Falso

String JSON contendo um valor que indica a configuração ativa a ser usada pelo backend de armazenamento. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

estado

string

Falso

String JSON contendo um valor que indica o estado operacional do backend de armazenamento. Os valores definidos são:

  • "descoberto" - O backend de armazenamento foi descoberto a partir de um cluster gerenciado

  • "running" - O backend de armazenamento está funcionando normalmente

  • "Desconhecido" - Não é possível determinar o estado do backend de armazenamento

  • "failed" - O backend de armazenamento está em um estado indisponível

stateDesired

string

Falso

String JSON contendo um valor que indica o estado operacional desejado do backend de armazenamento. Os valores definidos são:

  • "running" - O backend de armazenamento estará em estado de execução normal

stateUnready

array[string]

Falso

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual um backend de armazenamento não consegue transitar para o estado "em execução", por que transitou para o estado "com falha" ou "desconhecido" e/ou por que corre o risco de transitar para o estado "com falha". Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

managedState

string

Falso

String JSON contendo um valor que indica o estado de gerenciamento do backend de armazenamento. Os valores definidos são:

  • "Pendente" - O backend de armazenamento está programado para ser descoberto ou adicionado

  • "Não gerenciado" - O backend de armazenamento está em um estado "descoberto", não está sob gerenciamento e é elegível para gerenciamento

  • "Gerenciado" - O backend de armazenamento está em um estado "em execução" ou "desconhecido" e está sob gerenciamento

managedStateUnready

array[string]

Falso

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual o backend de armazenamento não é elegível para ser gerenciado. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

healthState

string

Falso

String JSON contendo um valor que indica o estado de integridade do backend de armazenamento. Os valores definidos são:

  • "Indeterminado" - O estado de saúde do recurso não pode ser determinado (por exemplo, devido à falta de conectividade)

  • "normal" - O recurso não apresenta problemas conhecidos e pode fornecer serviços de acordo com a especificação da interface

  • "Aviso" - O recurso apresenta problemas conhecidos que não o impedem de fornecer serviços de acordo com a especificação da interface

  • "Crítico" - O recurso apresenta problemas conhecidos que o impedem de fornecer serviços de acordo com a especificação da interface

healthStateUnready

array[string]

Falso

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual um backend de armazenamento não está em um estado normal de funcionamento. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

protectionState

string

Falso

String JSON contendo um valor que indica o estado de proteção do backend de armazenamento. "unknown" para ONTAP. Os valores definidos são:

  • "Protegido" - O backend de armazenamento possui uma política de proteção definida e está em conformidade com essa política

  • "partial" - O backend de armazenamento possui uma política de proteção definida, mas não está em conformidade com essa política

  • "nenhum" - O backend de armazenamento não está protegido

  • "Desconhecido" - Não foi possível determinar a conformidade da política de proteção do backend de armazenamento

  • enum: ["protegido", "parcial", "nenhum", "desconhecido"]

  • exemplo: protegido

protectionStateUnready

array[string]

Falso

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual uma política de proteção está em desacordo com as normas. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

ONTAP

"ONTAP"

Falso

Objeto JSON contendo informações específicas relacionadas a clusters ONTAP.

  • additionalProperties: falso

metadados

"type_astra_metadados_update"

Falso

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 solicitação 
{
  "type": "application/astra-storageBackend",
  "version": "1.3",
  "backendName": "st1-46"
}

Resposta

Status: 204, Indicates if the storageBackend resource was updated.

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

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
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: 409, Conflict
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

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

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/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

ONTAP

Objeto JSON contendo informações específicas relacionadas a clusters ONTAP.

Nome Tipo Obrigatório Descrição

IP de gerenciamento de backend

string

Falso

String JSON contendo o endereço IP usado para conectar-se a este cluster ONTAP.

managementIPs

array[string]

Falso

Array JSON de strings JSON contendo a lista de todos os endereços IP de gerenciamento possíveis usados para conectar-se a este cluster ONTAP. Isso é usado para correlacionar os backends detectados pelo Trident com os backends de armazenamento no Astra.

  • uniqueItems: 1

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

invalidFields

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do campo inválido no corpo da requisição

razão

string

Verdadeiro

Motivo pelo qual o campo do corpo da solicitação é inválido