Adição de tags em lote a um sistema de arquivos compartilhado
Função
Essa API é usada para adicionar tags em lote para um sistema de arquivos compartilhado.
Um sistema de arquivos compartilhado pode ter no máximo 10 tags.
As chaves de várias tags adicionadas a um sistema de arquivos compartilhado devem ser exclusivas.
Esta API é idempotente. Se a chave a ser adicionada já tiver sido adicionada ao sistema de arquivos compartilhado, a tag será atualizada.
URI
- POST /v2/{project_id}/sfs/{share_id}/tags/action
- Descrição do parâmetro
Parâmetro
Obrigatoriedade
Tipo
Descrição
project_id
Sim
String
Especifica o ID do projeto do operador. Para obter detalhes de como conseguir o ID do projeto, consulte Obtenção de um ID de projeto.
share_id
Sim
String
Especifica o ID do sistema de arquivos compartilhado.
Request Header
The operation message header is the same as that of a common request. For details, see Tabela 3.
Solicitação
- Descrição do parâmetro
Parâmetro
Obrigatoriedade
Tipo
Descrição
action
Sim
String
Especifica o identificador da operação. Os valores possíveis são create e delete. Use create para adicionar tags em lote a um sistema de arquivos compartilhado especificado.
tags
Não
Array of resource_tags
Especifica a lista de tags.
Esse parâmetro é obrigatório quando a permissão de locatário é usada. Para a permissão op_service, escolha este campo ou sys_tags.
sys_tags
Não
Array of resource_tags
Especifica a lista de tag do sistema.
Este campo está disponível apenas para a permissão op_service. Escolha este campo ou tags.
Somente uma chave da estrutura de resources_tag, _sys_enterprise_project_id, é usada em chamadas do TMS.
O valor é ID ou 0. Valor 0 indica o projeto empresarial padrão.
- Descrição do campo resource_tag
Parâmetro
Obrigatoriedade
Tipo
Descrição
key
Sim
String
Especifica a chave de tag. O valor pode conter no máximo 36 caracteres. A chave não pode ser deixada em branco e não pode conter caracteres ASCII não imprimíveis (0-31) ou os seguintes caracteres: =*<>\,|/
value
Sim
String
Especifica o valor de tag. O valor contém um máximo de 43 caracteres e pode ser uma cadeia de caracteres vazia. Não pode conter caracteres ASCII não imprimíveis (0-31) ou os seguintes caracteres: =*<>\,|/
- Exemplo de solicitação
{ "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
Códigos de estado
- Normal
- Anormal
Código de estado
Descrição
400 Bad Request
Valor inválido.
401 Unauthorized
Autenticação falhou.
403 Forbidden
O acesso à página solicitada é proibido.
404 Not Found
O recurso solicitado não foi encontrado.
500 Internal Server Error
A solicitação não foi concluída devido a um erro de serviço.