Creación de un sistema de archivos de uso general
Función
Esta API se utiliza para crear un sistema de archivos de uso general con un nombre especificado.
- El nombre de un sistema de archivos de uso general debe ser único en SFS. Si crea un sistema de archivos con el mismo nombre que uno existente creado por usted mismo en una región determinada, se devuelve una respuesta de éxito. En otros casos, si se crea un sistema de archivos con el mismo nombre, se devuelve un mensaje de error, lo que indica que el sistema de archivos ya existe.
- De forma predeterminada, puede crear hasta 100 sistemas de archivos.
- Si se elimina un sistema de archivos de uso general, puede crear un nuevo sistema de archivos con el mismo nombre después de al menos 12 horas.
Autorización
Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener los permisos requeridos específicamente asignados. Para conocer los permisos específicos requeridos, consulte Políticas de permisos y acciones admitidas.
URI
PUT /
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| Authorization | Sí | String | La información de la firma. |
| Date | Sí | String | La fecha y hora de la solicitud. |
| x-obs-az-redundancy | No | String | La redundancia de AZ, AZ única o múltiples AZ. |
| x-obs-bucket-type | Sí | String | El encabezado utilizado para especificar la creación del sistema de archivos de uso general. |
| Host | Sí | String | La dirección del host. |
| x-obs-epid | No | String | El ID del proyecto empresarial. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| Location | No | String | La región. |
Parámetros de respuesta
Esta respuesta utiliza los encabezados comunes. Para obtener más detalles, consulte Tabla 1.
(Opcional) Cuerpo de respuesta
El cuerpo de respuesta contiene información que no es el encabezado de respuesta. Por lo general, se envía en un formato estructurado (JSON o XML) definido por el parámetro de encabezado de respuesta Content-type.
Ejemplo de solicitud
- Cree un sistema de archivos de uso general en la región de example. La dirección del host es Host: example-sfs-01.sfs3.example.region.com:443. El ID del proyecto de empresa es 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>
Ejemplo de respuesta
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 estado
| Código de estado | Descripción |
|---|---|
| 200 | Se ha creado el sistema de archivos de uso general. |
Códigos de error
Consulte Códigos de error.