DescribeGrantRulesToCen - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Consulta as instâncias de rede entre contas que foram autorizadas para uma instância do Cloud Enterprise Network (CEN).

Descrição da operação

Chamar a operação DescribeGrantRulesToCen com parâmetros inválidos retorna um RequestId, mas não fornece informações sobre as instâncias de rede entre contas que a instância do CEN tem permissão para acessar.

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

cen:DescribeGrantRulesToCen

get

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região onde a instância de rede está localizada. Você pode chamar a operação para consultar os IDs de região.	cn-hangzhou
CenId	string	Sim	O ID da instância do CEN.	cen-nye53d7p3hzyu4****
ProductType	string	Sim	O tipo da instância de rede. Valores válidos: VPC: uma nuvem privada virtual (VPC). VBR: um roteador de borda virtual (VBR). CCN: uma instância do Cloud Connect Network (CCN). VPN: uma conexão IPsec-VPN. ECR: um roteador do Express Connect.	VPC
MaxResults	integer	Não	Se você omitir este parâmetro, todas as entradas serão retornadas. O valor de MaxResults na resposta indicará o número total de entradas. Se você definir este parâmetro, a resposta será paginada. O valor de MaxResults especifica o número de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. O valor de MaxResults na resposta indica o número de entradas na página atual. Recomenda-se definir MaxResults como 20.	20
NextToken	string	Não	O token usado para recuperar a próxima página de resultados. Omita este parâmetro na primeira solicitação. Defina este parâmetro com o valor de NextToken da resposta anterior para recuperar a próxima página de resultados.	FFmyTO70tTpLG6I3FmYAXGKPd****
ChildInstanceId	string	Não	O ID da instância de rede a ser consultada.	vpc-rj9gt5nll27onu7****
ChildInstanceOwnerId	integer	Não	O ID da conta Alibaba Cloud que possui a instância de rede.	1250123456123456
EnabledIpv6	boolean	Não	Especifica se o IPv6 está ativado. Este parâmetro se aplica apenas quando ProductType está definido como VPC. Defina como true para retornar apenas VPCs com IPv6 ativado, ou false para retornar apenas aquelas com IPv6 desativado. Se você omitir este parâmetro, a resposta não será filtrada pelo status do IPv6.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	4906B209-8613-5C19-9CC9-B7A3FFDA731C
GrantRules	object
GrantRule	array<object>	Uma lista de regras de concessão.
	object	Os detalhes da instância de rede.
ChildInstanceType	string	The type of the network instance. Valid values: VPC: A VPC. VBR: A VBR. CCN: A CCN instance. VPN: An IPsec-VPN connection. ECR: An ECR.	VPC
ChildInstanceRegionId	string	The region ID of the network instance.	cn-hangzhou
ChildInstanceOwnerId	integer	The ID of the Alibaba Cloud account that owns the network instance.	1250123456123456
ChildInstanceId	string	The ID of the network instance.	vpc-bp1rgeww9mdstuuar****
CenId	string	The ID of the CEN instance.	cen-nye53d7p3hzyu4****
OrderType	string	The payer for the network instance. Valid values: PayByCenOwner: The account that owns the CEN instance pays the transit router connection and data transfer fees for the network instance. PayByResourceOwner: The account that owns the network instance pays the transit router connection and data transfer fees for the network instance.	PayByCenOwner
EffectiveOrderType	string	The effective payer for the network instance.	PayByCenOwner
CenOwnerId	integer	The ID of the Alibaba Cloud account that owns the CEN instance.	1210123456123456
CreateTime	integer	The time when the permission was granted. The time is in UTC and follows the ISO 8601 standard.	2024-01-24T16:27Z
TotalCount	integer	O número total de entradas.	1
MaxResults	integer	O número máximo de entradas a serem retornadas por página. Este valor é igual ao valor de MaxResults que você especificou na solicitação.	20
NextToken	string	O token de paginação que é usado na próxima solicitação para recuperar uma nova página de resultados. Se o parâmetro NextToken estiver vazio, não há mais resultados disponíveis. Para recuperar a próxima página, defina o parâmetro de solicitação NextToken com este valor.	FFmyTO70tTpLG6I3FmYAXGKPd****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4906B209-8613-5C19-9CC9-B7A3FFDA731C",
  "GrantRules": {
    "GrantRule": [
      {
        "ChildInstanceType": "VPC",
        "ChildInstanceRegionId": "cn-hangzhou",
        "ChildInstanceOwnerId": 1250123456123456,
        "ChildInstanceId": "vpc-bp1rgeww9mdstuuar****",
        "CenId": "cen-nye53d7p3hzyu4****",
        "OrderType": "PayByCenOwner",
        "EffectiveOrderType": "PayByCenOwner",
        "CenOwnerId": 1210123456123456,
        "CreateTime": 0
      }
    ]
  },
  "TotalCount": 1,
  "MaxResults": 20,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	MissingParameter	Missing parameter.	The error message returned because one or more required parameters are not set.
400	InvalidParameter.RegionId	The specified Region Id is invalid.	The error message returned because the specified region ID is invalid.
400	IllegalParam.NextToken	NextToken is illegal	The error message returned because the NextToken parameter is set to an invalid value.
400	MissingParameter.RegionId	Missing RegionId parameter.	Missing RegionId parameter.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.