Criação de um sistema de arquivos de uso geral
Função
Essa API é usada para criar um sistema de arquivos de uso geral com um nome especificado.
- O nome de um sistema de arquivos de uso geral deve ser exclusivo no SFS. Se você criar um sistema de arquivos com o mesmo nome de um existente criado por você em uma determinada região, uma resposta de sucesso será retornada. Em outros casos, se um sistema de arquivos com o mesmo nome for criado, uma mensagem de erro será retornada, indicando que o sistema de arquivos já existe.
- Por padrão, você pode criar até 100 sistemas de arquivos.
- Se um sistema de arquivos de uso geral for excluído, você poderá criar um novo sistema de arquivos com o mesmo nome após pelo menos 12 horas.
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
PUT /
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Authorization | Sim | String | As informações de assinatura. |
| Date | Sim | String | O horário da solicitação. |
| x-obs-az-redundancy | Não | String | A redundância de AZ, AZ única ou multi-AZ. |
| x-obs-bucket-type | Sim | String | O cabeçalho usado para especificar a criação do sistema de arquivos de uso geral. |
| Host | Sim | String | O endereço do host. |
| x-obs-epid | Não | String | O ID do projeto empresarial. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Location | Não | String | A região. |
Parâmetros de resposta
Esta resposta usa cabeçalhos comuns. Para obter detalhes, consulte Tabela 1.
(Opcional) Corpo da resposta
Um corpo de resposta contém informações além do cabeçalho de resposta. Ele é geralmente enviado em um formato estruturado (JSON ou XML) definido pelo parâmetro de cabeçalho de resposta Content-type.
Exemplo de solicitação
- Crie um sistema de arquivos de uso geral na região exemplo. O endereço do host é Host: example-sfs-01.sfs3.example.region.com:443. O ID do projeto empresarial é 0.
PUT / HTTP/1.1 Host: example-sfs-01.sfs3.example.region.com:443Date: Wed, 07 Jun 2023 02:38:09 GMT x-obs-bucket-type: SFS Authorization: OBS FNEX1B77SXDIB3TFMSZZ:0Xsnu4hJVOI7VWH0wIQczVN+rbg= Content-Length: 85 x-obs-epid: 0 <CreateBucketConfiguration> <Location>example</Location> </CreateBucketConfiguration>
Exemplo de resposta
HTTP/1.1 200 OK Server: OBS X-Obs-Request-Id: 0000018893B8058EC0470388BE6EDE88 Location: /example-sfs-01 X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCTRa4voOUvr50ncznQT/hligMxL4so2z Date: Wed, 07 Jun 2023 02:38:11 GMT Content-Length: 0
Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | O sistema de arquivos de uso geral foi criado. |
Códigos de erro
Consulte Códigos de erro.