Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Scalable File Service/ Referencia de la API/ API orientadas a la capacidad de SFS/ Sistemas de archivos/ Consulta de detalles acerca de un sistema de archivos compartido

Actualización más reciente 2023-02-27 GMT+08:00

Ver PDF

Consulta de detalles acerca de un sistema de archivos compartido

Función

Esta API se utiliza para consultar los detalles sobre un sistema de archivos compartido.

URI

GET /v2/{project_id}/shares/{share_id}

Descripción del parámetro

Parámetro	Obligatorio	Tipo	Descripción
share_id	Sí	String	Especifica el ID del sistema de archivos compartido.
project_id	Sí	String	Especifica el ID de proyecto del operador. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Request Header

The operation message header is the same as that of a common request. For details, see Tabla 3.

Solicitud

Descripción del parámetro
Ninguno
Solicitud de ejemplo
Ninguno

Respuesta

Descripción del parámetro

Parámetro	Tipo	Descripción
share	Object	Especifica los objetos de share.

Descripción del campo share

Parámetro	Tipo	Descripción
links	Array	Especifica los vínculos de los sistemas de archivos compartidos.
availability_zone	String	Especifica la zona de disponibilidad.
share_server_id	String	Especifica el ID para administrar los servicios compartidos.
share_network_id	String	Especifica el ID de la red compartida. Este parámetro está reservado porque actualmente no se admite la gestión de redes compartidas.
snapshot_id	String	Especifica el ID de la instantánea de origen que se utiliza para crear el sistema de archivos compartido. Este parámetro está reservado, ya que las instantáneas no son compatibles actualmente.
snapshot_support	Boolean	Especifica si se admiten instantáneas. Este parámetro está reservado, ya que las instantáneas no son compatibles actualmente. Este campo es compatible con API v2.2 y versiones posteriores.
id	String	Especifica el ID del sistema de archivos compartido.
size	Integer	Especifica el tamaño (GB) del sistema de archivos compartido.
consistency_group_id	String	Especifica el ID del grupo de consistencia. Este parámetro está reservado porque actualmente no se admiten grupos de consistencia. Este campo es compatible con las versiones de API de v2.31 a v2.42.
project_id	String	Especifica el ID del proyecto al que pertenece el sistema de archivos compartido.
metadata	Object	Establece uno o más pares de clave y valor de metadatos como un diccionario de cadenas. El valor de la clave share_used indica la capacidad utilizada del sistema de archivos, en bytes. La capacidad utilizada no se mostrará si se utiliza menos de 1 MB del sistema de archivos SFS orientado a la capacidad. El valor de enterprise_project_id indica el ID del proyecto de empresa al que pertenece el sistema de archivos.
status	String	Especifica el estado del sistema de archivos compartido.
task_state	String	Especifica el estado de migración de datos. Este parámetro está reservado, ya que actualmente no se admite la migración de datos. Este campo es compatible con API v2.5 y versiones posteriores.
has_replicas	Boolean	Especifica si existen réplicas. Este parámetro está reservado, ya que actualmente no se admite la replicación. Este campo es compatible con las versiones de API de v2.11 a v2.42.
replication_type	String	Especifica el tipo de replicación. Este parámetro está reservado, ya que actualmente no se admite la replicación. Este campo es compatible con las versiones de API de v2.11 a v2.42.
description	String	Describe el sistema de archivos compartido.
host	String	Especifica el nombre del host.
name	String	Especifica el nombre del sistema de archivos compartido.
created_at	String	Especifica la marca de fecha y hora cuando se creó el sistema de archivos compartido.
share_proto	String	Especifica el protocolo para compartir sistemas de archivos.
share_type_name	String	Especifica el tipo de servicio de almacenamiento asignado para el sistema de archivos compartido, como el almacenamiento de alto rendimiento (compuesto por SSD) y el almacenamiento de gran capacidad (compuesto por discos SATA). Este campo es compatible con API v2.6 y versiones posteriores.
share_type	String	Especifica el ID del tipo de sistema de archivos.
volume_type	String	Especifica el tipo de volumen. La definición de este parámetro es la misma que la de share_type.
export_locations	Array	Muestra las ubicaciones de montaje. Actualmente, solo se admite una única ubicación de montaje. Este parámetro solo existe cuando X-Openstack-Manila-Api-Version especificado en el encabezado de solicitud es menor que 2.9.
export_location	String	Especifica la ubicación de montaje. Este parámetro solo existe cuando X-Openstack-Manila-Api-Version especificado en el encabezado de solicitud es menor que 2.9.
is_public	Boolean	Especifica el nivel de visibilidad del sistema de archivos compartido. Si se devuelve true, el sistema de archivos se puede ver públicamente. Si se devuelve false, el sistema de archivos se puede ver de forma privada. El valor predeterminado es false.

Ejemplo de respuesta

{
  "share": {
    "status": "available",
    "share_type_name": "sla",
    "description": "My custom share London",
    "links": [
      {
        "href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
        "rel": "self"
      },
      {
        "href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
        "rel": "bookmark"
      }
    ],
    "availability_zone": "az1.dc1",
    "share_network_id": null,
    "share_server_id": null,
    "share_group_id": null,
    "host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
    "revert_to_snapshot_support": null,
    "access_rules_status": "active",
    "snapshot_id": null,
    "create_share_from_snapshot_support": null,
    "is_public": false,
    "task_state": null,
    "snapshot_support": true,
    "id": "f26d867f-9876-433d-8db2-25d210f29309",
    "size": 1,
    "source_share_group_snapshot_member_id": null,
    "user_id": "daa3f8f8d7254465841da769298a76f6",
    "name": "luzhongguo_1",
    "share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
    "has_replicas": false,
    "replication_type": null,
    "created_at": "2018-12-25T08:45:22.525899",
    "share_proto": "NFS",
    "volume_type": "sla",
    "mount_snapshot_support": null,
    "project_id": "07412155bf474db9a2f697fd978593d7",
    "metadata": {
      "share_key": "test",
      "share_used": "1",
    }
  }
}

Códigos de estado

Normal
200

Anormal

Código de estado	Descripción
400 Bad Request	Se produjo un error en el servidor al procesar la solicitud.
401 Unauthorized	Debe introducir un nombre de usuario y la contraseña para acceder a la página solicitada.
403 Forbidden	El acceso a la página solicitada está prohibido.
404 Not Found	La página solicitada no se ha podido encontrar.
405 Method Not Allowed	No se le permite utilizar el método especificado en la solicitud.
406 Not Acceptable	El cliente no pudo aceptar la respuesta generada por el servidor.
407 Proxy Authentication Required	Debe utilizar el servidor proxy para la autenticación. Entonces la solicitud puede ser procesada.
408 Request Timeout	Se agotó el tiempo de espera de la solicitud.
409 Conflict	La solicitud no se pudo procesar debido a un conflicto.
500 Internal Server Error	Se produjo un error al completar la solicitud debido a un problema de servicio interno.
501 Not Implemented	Error al completar la solicitud porque el servidor no admite la función solicitada.
502 Bad Gateway	Error al completar la solicitud porque la solicitud no es válida.
503 Service Unavailable	Se produjo un error al completar la solicitud porque el servicio no está disponible.
504 Gateway Timeout	Se ha producido un error de tiempo de espera de la puerta de enlace.