Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Computação
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gerenciamento e governança
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migração
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análises
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Outros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Segurança e conformidade
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Anti-DDoS Service
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Serviços de mídia
Media Processing Center
Video On Demand
Live
SparkRTC
Armazenamento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Cloud Server Backup Service
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Data Express Service
Dedicated Distributed Storage Service
Containers
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bancos de dados
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicações de negócios
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribuição de conteúdo e computação de borda
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluções
SAP Cloud
High Performance Computing
Serviços para desenvolvedore
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
MacroVerse aPaaS
KooPhone
KooDrive

Consulta de snapshots do EVS

Atualizado em 2024-09-25 GMT+08:00

Função

Consultar snapshots do EVS

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

GET /v3/{project_id}/snapshots

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

O ID do projeto.

Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto.

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

marker

Não

String

O ID do recurso a partir do qual a consulta de paginação é iniciada. É o ID do último recurso na página anterior.

offset

Não

Integer

O deslocamento.

NOTA:

Observação: esse parâmetro é usado quando snapshots são consultados por página e é usado em conjunto com o parâmetro limit. Por exemplo, há um total de 30 snapshots. Se você definir offset para 11 e limit para 10, a consulta começará a partir do décimo segundo snapshot e um máximo de 10 snapshots poderão ser consultados por vez.

limit

Não

Integer

O número máximo de resultados de consulta que podem ser retornados.

O valor varia de 1 a 1000 e o valor padrão é 1000. O valor retornado não pode exceder esse limite.

Se o locatário tiver mais de 50 snapshots no total, é recomendável usar esse parâmetro e definir seu valor como 50 para melhorar a eficiência da consulta. Os exemplos são fornecidos como a seguir:

Consultar 1–50 snapshots: GET /v2/xxx/snapshots?limit=50; consultar 51–100 snapshots: GET /v2/xxx/snapshots?offset=50&limit=50

name

Não

String

O nome do snapshot. Este parâmetro não suporta correspondência difusa. Você pode inserir até 255 caracteres.

status

Não

String

O status do snapshot. Para obter detalhes, consulte Status do snapshot do EVS.

volume_id

Não

String

O ID do disco de origem do snapshot.

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

snapshots_links

Array of Link objects

O marcador de posição da consulta na lista de snapshots. Esse campo é retornado somente quando limit é especificado na solicitação, e esse campo indica que apenas alguns snapshots são retornados nessa consulta.

snapshots

Array of SnapshotSummary objects

As informações do snapshot.

Tabela 6 SnapshotSummary

Parâmetro

Tipo

Descrição

created_at

String

A hora em que o snapshot foi criado.

Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

description

String

A descrição do snapshot.

id

String

O ID do snapshot.

metadata

Map<String,String>

Os metadados do snapshot.

Se metadata contiverem o campo __system__enableActive, o snapshot será um snapshot gerado automaticamente durante um backup do servidor.

name

String

O nome do snapshot.

size

Integer

O tamanho do snapshot, em GiB.

status

String

O status do snapshot. Para obter detalhes, consulte Status do snapshot do EVS.

updated_at

String

A hora em que o snapshot foi atualizado.

Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

volume_id

String

O ID do disco de origem do snapshot.

Código de status: 400

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro.

Tabela 8 Error

Parâmetro

Tipo

Descrição

code

String

O código de erro retornado se ocorrer um erro.

Para obter detalhes sobre códigos de erro e seus significados, consulte Códigos de erro.

message

String

A mensagem de erro retornada se ocorrer um erro.

Exemplo de solicitações

GET https://{endpoint}/v3/{project_id}/snapshots?status=available

Exemplo de respostas

Código de status: 200

OK

{
  "snapshots" : [ {
    "created_at" : "2016-02-16T16:54:14.981520",
    "description" : null,
    "id" : "b836dc3d-4e10-4ea4-a34c-8f6b0460a583",
    "metadata" : { },
    "name" : "test01",
    "size" : 1,
    "status" : "available",
    "volume_id" : "ba5730ea-8621-4ae8-b702-ff0ffc12c209",
    "updated_at" : null
  }, {
    "created_at" : "2016-02-16T16:54:19.475397",
    "description" : null,
    "id" : "83be494d-329e-4a78-8ac5-9af900f48b95",
    "metadata" : { },
    "name" : "test02",
    "size" : 1,
    "status" : "available",
    "volume_id" : "ba5730ea-8621-4ae8-b702-ff0ffc12c209",
    "updated_at" : null
  }, {
    "created_at" : "2016-02-16T16:54:24.367414",
    "description" : null,
    "id" : "dd360f46-7593-4d35-8f2c-5566fd0bd79e",
    "metadata" : { },
    "name" : "test03",
    "size" : 1,
    "status" : "available",
    "volume_id" : "ba5730ea-8621-4ae8-b702-ff0ffc12c209",
    "updated_at" : null
  }, {
    "created_at" : "2016-02-16T16:54:29.766740",
    "description" : null,
    "id" : "4c29796a-8cf4-4482-9afc-e66da9a81240",
    "metadata" : { },
    "name" : "test04",
    "size" : 1,
    "status" : "available",
    "volume_id" : "ba5730ea-8621-4ae8-b702-ff0ffc12c209",
    "updated_at" : null
  } ],
  "snapshots_links" : null
}

Código de status: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

200

OK

400

Bad Request

Códigos de erro

Consulte Códigos de erro.

Usamos cookies para aprimorar nosso site e sua experiência. Ao continuar a navegar em nosso site, você aceita nossa política de cookies. Saiba mais

Feedback

Feedback

Feedback

0/500

Conteúdo selecionado

Envie o conteúdo selecionado com o feedback