Obtenção da lista de membros de compartilhamento
Função
Esta API é usada para obter a lista de membros de compartilhamento de backup.
URI
GET /v3/{project_id}/backups/{backup_id}/members
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
backup_id |
Sim |
String |
ID do backup |
project_id |
Sim |
String |
ID do projeto |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
dest_project_id |
Não |
String |
ID do projeto com o qual o backup é compartilhado |
image_id |
Não |
String |
ID da imagem criada a partir do backup aceito |
limit |
Não |
Integer |
Número de registros exibidos por página. O valor deve ser um número inteiro positivo. |
marker |
Não |
String |
ID do último registro exibido na página anterior. Somente UUID é suportado. |
offset |
Não |
Integer |
Valor de deslocamento, que é um inteiro positivo. |
sort |
Não |
String |
Um grupo de propriedades separadas por vírgulas (,) e direções de classificação. O formato do valor é [:],[:], onde o valor da direção é asc (em ordem crescente) ou desc (em ordem decrescente). Se a direção do parâmetro não for especificada, a direção de classificação padrão é desc. O valor de sort contém no máximo 255 caracteres. |
status |
Não |
String |
Status de um backup compartilhado |
vault_id |
Não |
String |
ID do cofre onde backup compartilhado está armazenado. Somente UUID é suportado. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token de usuário. O token 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
Parâmetro |
Tipo |
Descrição |
---|---|---|
members |
Array of Member objects |
Parâmetros de resposta da adição de um membro de compartilhamento de backup |
count |
Integer |
Número de membros de compartilhamento com os quais o backup é compartilhado |
Parâmetro |
Tipo |
Descrição |
---|---|---|
status |
String |
Estado do compartilhamento de backup Valores de enumeração:
|
created_at |
String |
Tempo de compartilhamento de backup, por exemplo, 2020-02-05T10:38:34.209782 |
updated_at |
String |
Tempo de atualização, por exemplo, 2020-02-05T10:38:34.209782 |
backup_id |
String |
ID do backup |
image_id |
String |
ID da imagem criada usando o backup compartilhado aceito |
dest_project_id |
String |
ID do projeto com o qual o backup é compartilhado |
vault_id |
String |
ID do cofre onde o backup compartilhado está armazenado |
id |
String |
ID do registro compartilhado |
Exemplo de solicitações
GET https://{endpoint}/v3/{project_id}/backups/{backup_id}/members
Exemplo de respostas
Código de status: 200
OK
{ "members" : [ { "status" : "pending", "image_id" : null, "backup_id" : "0b07081e-3ec7-4e77-8571-54e2947da422", "vault_id" : null, "dest_project_id" : "075e6035d300d48c2fd0c00b78b71ebf", "created_at" : "2020-02-05T10:38:34.209782", "updated_at" : null, "id" : "3c5a3015-c3a0-4dc6-a1e2-917b90f62319" } ], "count" : 50 }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
Códigos de erro
Consulte Códigos de erro.