DescribeGlobalDataNetworkList - PolarDB - Centro de documentación de Alibaba Cloud

Consulta los detalles de las redes de base de datos global (GDN) de Polarlakebase en todas las regiones.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:DescribeGlobalDataNetworkList

list

*Todos los recursos.

*

Ninguna

Sintaxis de la solicitud

GET  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
PageNumber	integer	No	El número de página de los resultados de la consulta.	1
PageSize	integer	No	El número de registros por página.	30

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de respuesta.
RequestId	string	El ID de la solicitud.	CD35F3-F3-44CA-AFFF-BAF869******
TotalRecordCount	string	El número total de registros.	1
PageRecordCount	string	El número de registros en la página actual.	1
PageNumber	string	El número de página.	1
Items	object	Los detalles de la GDN.
Networks	array<object>	La lista de redes GDN.
	array<object>	Los detalles de la red GDN.
NetworkId	string	El ID de la GDN.	gdn-xxx
NetworkDescription	string	La descripción de la GDN.	migdn
NetworkStatus	string	El estado de la GDN. Valores válidos: Creating: En creación. Running: En ejecución. Syncing: En sincronización. SyncFinished: Sincronización completada. SyncFailed: Sincronización fallida. SyncPartialFailed: Sincronización parcial fallida. Stopped: Detenido. Maintaining: En mantenimiento. Restarting: En reinicio. Locking: En bloqueo. Locked: Bloqueado. Unlocking: En desbloqueo. Deleting: En eliminación. Deleted: Eliminado.	Running
NetworkTopology	object	La topología de la red GDN.
Sources	array<object>	La lista de orígenes de sincronización.
	object	El origen de sincronización.
SourceFileSystemPath	string	La ruta de origen.	/
SourceType	string	El tipo de origen. Valores válidos: pfs: Edición de alto rendimiento de Polarlakebase. pcs: Edición de almacenamiento en frío de Polarlakebase.	pcs
SourceRegion	string	La región de origen.	cn-wulanchabu
SourceId	string	La instancia de Polarlakebase de origen.	pcs-xxx
Destinations	array<object>	La lista de destinos de sincronización.
	object	El destino de sincronización.
DestinationFileSystemPath	string	La ruta de destino.	/
DestinationRegion	string	La región de destino.	cn-beijing
DestinationType	string	El tipo de destino. Valores válidos: pfs: Edición de alto rendimiento de Polarlakebase. pcs: Edición de almacenamiento en frío de Polarlakebase.	pfs
DestinationId	string	La instancia de Polarlakebase de destino.	pfs-xxx
CreateTime	string	La hora de creación de la GDN. La hora está en el formato ISO 8601 en UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2025-03-25T09:37:10Z
Channels	array<object>	La lista de canales de sincronización.
	object	El canal de sincronización.
ChannelId	string	El ID del canal de sincronización.	gdc-xxx
ChannelStatus	string	El estado del canal de sincronización. Valores válidos: Creating: En creación. Running: En ejecución. Syncing: En sincronización. SyncFinished: Sincronización completada. SyncFailed: Sincronización fallida. SyncPartialFailed: Sincronización parcial fallida. Stopped: Detenido. Maintaining: En mantenimiento. Restarting: En reinicio. Locking: En bloqueo. Locked: Bloqueado. Unlocking: En desbloqueo. Deleting: En eliminación. Deleted: Eliminado.	Syncing
Progress	string	El progreso de sincronización actual. Nota El valor es un porcentaje de punto flotante con dos decimales.	11.45%
FreezeSourceDuringSync	boolean	Indica si se congela la ruta de origen durante la transferencia.	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "CD35F3-F3-44CA-AFFF-BAF869******",
  "TotalRecordCount": "1",
  "PageRecordCount": "1",
  "PageNumber": "1",
  "Items": {
    "Networks": [
      {
        "NetworkId": "gdn-xxx",
        "NetworkDescription": "mygdn",
        "NetworkStatus": "Running",
        "NetworkTopology": {
          "Sources": [
            {
              "SourceFileSystemPath": "/",
              "SourceType": "pcs",
              "SourceRegion": "cn-wulanchabu",
              "SourceId": "pcs-xxx"
            }
          ],
          "Destinations": [
            {
              "DestinationFileSystemPath": "/",
              "DestinationRegion": "cn-beijing",
              "DestinationType": "pfs",
              "DestinationId": "pfs-xxx"
            }
          ]
        },
        "CreateTime": "2025-03-25T09:37:10Z",
        "Channels": [
          {
            "ChannelId": "gdc-xxx",
            "ChannelStatus": "Syncing",
            "Progress": "11.45%",
            "FreezeSourceDuringSync": true
          }
        ]
      }
    ]
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.