Skip to main content
Astra Automation
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.

Liste todos os buckets

PDFs

GET /accounts/{account_id}/topology/v1/buckets

Retorna uma matriz JSON com todos os recursos correspondentes na coleção. Se campos individuais forem especificados na solicitação, a matriz JSON de itens conterá os campos solicitados para cada recurso correspondente na ordem especificada.

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

Resposta

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Nome Tipo Obrigatório Descrição

itens

array[Qualquer um de: "bucket_1.2_get_response_body", array[]]

Verdadeiro

metadados

"type_astra_metadata_list"

Verdadeiro
Exemplo de resposta 
{
  "type": "application/astra-buckets",
  "version": "1.2",
  "items": [
    [
      "4c753e39-25e9-4b36-a8de-69f168aa59cd",
      "Test Bucket",
      "gcp"
    ],
    [
      "d8fd585d-6429-4c08-a308-af193a88eac7",
      "Local",
      "ontap-s3"
    ]
  ],
  "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

additionalDetails

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

Falso

s3

Objeto JSON que fornece parâmetros do protocolo Simple Storage Service (S3). (Use este objeto para todos os provedores do tipo S3).

Nome Tipo Obrigatório Descrição

URL do servidor

string

Verdadeiro

String JSON contendo um URL para o caminho base do bucket. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 1023

bucketName

string

Verdadeiro

String JSON contendo o nome do bucket S3. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

gcp

Objeto JSON que fornece parâmetros do protocolo Google Cloud.

Nome Tipo Obrigatório Descrição

bucketName

string

Verdadeiro

String JSON contendo o nome do bucket do Google Cloud que está sendo usado como base. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

azure

Objeto JSON que fornece parâmetros do protocolo Azure.

Nome Tipo Obrigatório Descrição

storageAccount

string

Verdadeiro

String JSON contendo o nome da conta de armazenamento do Azure. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

bucketName

string

Verdadeiro

String JSON contendo o nome do blob do Azure subjacente. Os valores definidos são:

  • Comprimento mínimo: 0

  • Comprimento máximo: 63

bucketParameters

Objeto JSON que fornece informações específicas do provedor do bucket, necessárias para acessar o bucket. Os valores específicos neste bucket variam de acordo com o provedor.

Nome Tipo Obrigatório Descrição

s3

"s3"

Falso

Objeto JSON que fornece parâmetros do protocolo Simple Storage Service (S3). (Use este objeto para todos os provedores do tipo S3).

gcp

"gcp"

Falso

Objeto JSON que fornece parâmetros do protocolo Google Cloud.

azure

"azure"

Falso

Objeto JSON que fornece parâmetros do protocolo Azure.

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:

  • Conforme 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

bucket_1.2_get_response_body

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

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

  • "application/astra-bucket"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

nome

string

Verdadeiro

String JSON contendo um nome atribuído pelo usuário para o bucket. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 256

ID da credencial

string

Verdadeiro

String JSON contendo o identificador das credenciais usadas para acessar o bucket. Valores definidos são:

  • Conforme o esquema de identificador Astra

estado

string

Verdadeiro

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

  • "Pendente" - O bucket está programado para descoberta

  • "disponível" - O bucket está disponível para uso

  • "failed" - O bucket está em estado de falha permanente

  • "removido" - O bucket não está acessível no momento

  • "desconhecido" - O estado do bucket não pode ser determinado

stateDetails

array["type_astra_stateDetail"]

Verdadeiro

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo da transição do "state" para "removed" ou "failed". Se não houver detalhes disponíveis, esta matriz estará vazia.

  • Itens mínimos: 0

retentionTime

número

Falso

Número de segundos que representa o tempo durante o qual um arquivo neste bucket será retido. Os valores definidos são:

  • -1 (Balde não suportado)

  • 0 (sem política de retenção conhecida) *

    0 (Known política de retenção)

provedor

string

Verdadeiro

String JSON que indica o protocolo do bucket que pode ser usado para acessar o bucket. Os valores definidos são:

  • "ontap-s3"

  • "storagegrid-s3"

  • "generic-s3"

  • "gcp"

  • "azure"

  • "aws"

bucketParameters

"bucketParameters"

Verdadeiro

Objeto JSON que fornece informações específicas do provedor do bucket, necessárias para acessar o bucket. Os valores específicos neste bucket variam de acordo com o provedor.

metadados

"type_astra_metadados_update"

Verdadeiro

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

  • Conforme 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.

type_astra_metadata_list

Nome Tipo Obrigatório Descrição

continuar

string

Falso

contar

número

Falso

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