DescribeGlobalDataNetworkList - PolarDB: Central de Documentação do Alibaba Cloud

Obtém os detalhes das Redes Globais de Dados (GDNs) do Polarlakebase em todas as regiões da sua conta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:DescribeGlobalDataNetworkList

list

*All Resource

*

Nenhuma

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PageNumber	integer	Não	O número da página a ser retornada.	1
PageSize	integer	Não	O número de registros a serem retornados em cada página.	30

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	CD35F3-F3-44CA-AFFF-BAF869******
TotalRecordCount	string	O número total de registros.	1
PageRecordCount	string	O número de registros na página atual.	1
PageNumber	string	O número da página.	1
Items	object	Os detalhes das Redes Globais de Dados (GDNs).
Networks	array<object>	A lista de redes GDN.
	array<object>	Os detalhes da Rede Global de Dados (GDN).
NetworkId	string	The ID of the GDN.	gdn-xxx
NetworkDescription	string	The description of the GDN.	mygdn
NetworkStatus	string	The status of the GDN. Valid values: Creating: The GDN is being created. Running: The GDN is running. Syncing: The GDN is synchronizing data. SyncFinished: Data synchronization is complete. SyncFailed: Data synchronization failed. SyncPartialFailed: Data synchronization partially failed. Stopped: The GDN is stopped. Maintaining: The GDN is under maintenance. Restarting: The GDN is restarting. Locking: The GDN is being locked. Locked: The GDN is locked. Unlocking: The GDN is being unlocked. Deleting: The GDN is being deleted. Deleted: The GDN is deleted.	Running
NetworkTopology	object	The network topology of the GDN.
Sources	array<object>	The synchronization sources.
	object	Details about the synchronization source.
SourceFileSystemPath	string	The source path.	/
SourceType	string	The type of the source. Valid values: pfs: Polarlakebase High-performance Edition. pcs: Polarlakebase Cold Storage Edition.	pcs
SourceRegion	string	The region of the source.	cn-wulanchabu
SourceId	string	The ID of the source Polarlakebase instance.	pcs-xxx
Destinations	array<object>	The synchronization destinations.
	object	Details about the synchronization destination.
DestinationFileSystemPath	string	The destination path.	/
DestinationRegion	string	The region of the destination.	cn-beijing
DestinationType	string	The type of the destination. Valid values: pfs: Polarlakebase High-performance Edition. pcs: Polarlakebase Cold Storage Edition.	pfs
DestinationId	string	Destination PolarDB instance	pfs-xxx
CreateTime	string	The time when the GDN was created.	2025-03-25T09:37:10Z
Channels	array<object>	The synchronization channels.
	object	Details about the synchronization channel.
ChannelId	string	The ID of the synchronization channel.	gdc-xxx
ChannelStatus	string	The status of the synchronization channel. Valid values: Creating: The channel is being created. Running: The channel is running. Syncing: The channel is synchronizing data. SyncFinished: Data synchronization is complete. SyncFailed: Data synchronization failed. SyncPartialFailed: Data synchronization partially failed. Stopped: The channel is stopped. Maintaining: The channel is under maintenance. Restarting: The channel is restarting. Locking: The channel is being locked. Locked: The channel is locked. Unlocking: The channel is being unlocked. Deleting: The channel is being deleted. Deleted: The channel is deleted.	Syncing
Progress	string	The synchronization progress. Nota The value is a percentage that is accurate to two decimal places.	11.45%
FreezeSourceDuringSync	boolean	Indicates whether the source path is frozen during data transmission.	true

Exemplos

Resposta de sucesso

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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.