Adição de tags em lote a um recurso
Função
Esta API é usada para adicionar tags em lote a um sistema de arquivos de uso geral. Você pode adicionar até 20 tags a um recurso.
Autorização
Cada conta tem todas as permissões necessárias para chamar todas as APIs, mas os usuários do IAM devem ter as permissões necessárias especificamente atribuídas. Para obter as permissões específicas necessárias, consulte Políticas de permissões e ações suportadas.
URI
- POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
- Descrição do parâmetro
Parâmetro
Obrigatório
Tipo
Descrição
project_id
Sim
String
O ID do projeto. Para obter detalhes, consulte Obtenção de um ID de projeto.
resource_id
Sim
String
O ID do recurso, que é o nome de um sistema de arquivos de uso geral.
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Content-type | Sim | String | O tipo MIME do corpo da solicitação. Exemplo: application/json |
| X-Auth-Token | Não | String | O token do usuário. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| tags | Não | List<resource_tag> | A lista de tags. Para obter detalhes, consulte Tabela 3. Este parâmetro é obrigatório para locatários comuns. Use tags ou sys_tags se você tiver as permissões de op_service. |
| sys_tags | Não | List<resource_tag> | A lista de tags do sistema. Este parâmetro está disponível apenas para as permissões de op_service. Use tags ou sys_tags se você tiver as permissões de op_service. Atualmente, apenas uma estrutura de resource_tag é usada em chamadas do TMS. A chave é fixada em _sys_enterprise_project_id. O valor pode ser UUID ou 0. 0 indica o projeto corporativo padrão. Somente tags do sistema podem ser adicionadas. Para obter detalhes, consulte Tabela 3. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| key | Sim | String | A chave da tag. Uma chave de tag pode conter no máximo 128 caracteres. Pode conter letras, dígitos e espaços representáveis em UTF-8 e caracteres especiais (_.:=+-@). Não pode começar ou terminar com um espaço e não pode ser deixada em branco. Chaves de tag que começam com _sys_ são tags do sistema, e você não pode iniciar uma chave de tag com _sys_. |
| value | Sim | String | O valor da tag. Um valor de tag pode conter no máximo 255 caracteres. Pode conter letras, dígitos e espaços representáveis em UTF-8 e caracteres especiais (_.:=+-@) e pode ser deixado em branco. Não pode começar ou terminar com um espaço. |
Parâmetros de resposta
Nenhum
Exemplo de solicitação
Batch adding tags to a general-purpose file system whose name is bucketName with the project ID c80a2157ba1d46c0825265947342077c:
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create Exemplo de corpo da solicitação:
{
"tags":[
{
"key":"key1",
"value":"value1"
},
{
"key":"key2",
"value":"value2"
}
]
} Exemplo de resposta
Nenhum
Códigos de status
- Normal
| Código de status | Descrição |
|---|---|
| 204 | Tags de recursos adicionadas em um lote. |
- Anormal
| Código de status | Descrição |
|---|---|
| 400 | Parâmetro de tag inválido. |
| 401 | Falha na certificação. |
| 403 | Falha na autenticação. |
| 404 | Recurso não encontrado. |
| 500 | Erro do sistema. |