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.