Consulta de información del proyecto
Función
Esta API se utiliza para consultar información del proyecto.
Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.
URI
GET /v3/projects
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| domain_id | No | String | ID de cuenta del proyecto de destino. Para obtener más información sobre cómo obtener el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
| enabled | No | Boolean | Habilitación del estado del proyecto. |
| is_domain | No | Boolean | Deje este campo en blanco. |
| name | No | String | Nombre del proyecto. Para obtener más información sobre cómo obtener el nombre del proyecto, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
| page | No | Integer | Número de página para consulta de paginación. El valor mínimo es de 1. Este parámetro debe usarse junto con per_page. |
| parent_id | No | String | Especifique el ID de un subproyecto. También puede especificar el ID de cuenta de un proyecto de sistema, por ejemplo, el proyecto de ap-southeast-1. Para obtener más información acerca de cómo obtener el ID de proyecto y el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
| per_page | No | Integer | Número de registros de datos que se mostrarán en cada página. El valor oscila entre 1 y 5000. Este parámetro debe usarse junto con page. |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| Content-Type | Sí | String | Rellene application/json;charset=utf8 en este campo. |
| X-Auth-Token | Sí | String | Token de acceso emitido a un usuario para que porte su identidad y permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones. |
Parámetros de respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| Object | Información de enlace de recurso. | |
| Array of objects | Información del proyecto. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| self | String | Enlace de recurso. |
| previous | String | Enlace de recurso anterior. |
| next | String | Siguiente enlace de recurso. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| is_domain | Boolean | El valor es false. |
| description | String | Descripción del proyecto. |
| Object | Enlace de recursos del proyecto. | |
| enabled | Boolean | Habilitación del estado del proyecto. |
| id | String | ID del proyecto. |
| parent_id | String | ID del subproyecto especificado o ID de cuenta de un proyecto de sistema especificado, por ejemplo, el proyecto ap-southeast-1. |
| domain_id | String | ID de cuenta. |
| name | String | Nombre del proyecto. Por ejemplo, ap-southeast-1 y MOS. MOS es un proyecto integrado de OBS. |
Solicitud de ejemplo
Solicitud de consulta de información del proyecto
GET https://iam.myhuaweicloud.com/v3/projects Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{
"projects": [
{
"domain_id": "d78cbac186b744899480f25bd02...",
"is_domain": false,
"parent_id": "d78cbac186b744899480f25bd022...",
"name": "ap-southeast-1",
"description": "",
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/projects/06f1c15e6f0010672f86c003006c5f17"
},
"id": "06f1c15e6f0010672f86c00300...",
"enabled": true
},
{
"domain_id": "d78cbac186b744899480f25bd...",
"is_domain": false,
"parent_id": "d78cbac186b744899480f25bd0...",
"name": "ap-southeast-1",
"description": "",
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/projects/065a7c66da0010992ff7c0031e5a..."
},
"id": "065a7c66da0010992ff7c0031e5a...",
"enabled": true
}
],
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/projects"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | La solicitud se ha realizado correctamente. |
| 400 | Parámetros no válidos. |
| 401 | Error de autenticación. |
| 403 | Acceso denegado. |
| 404 | No se puede encontrar el recurso solicitado. |
| 500 | Error de servidor interno. |
| 503 | Servicio no disponible. |
Códigos de error
Ninguno
