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

Consulta informações sobre instâncias de rede entre contas que estão autorizadas a serem associadas a uma instância do Cloud Enterprise Network (CEN).

Descrição da operação

Ao chamar a operação DescribeGrantRulesToCen, certifique-se de que os valores dos parâmetros especificados sejam válidos. Se você especificar valores de parâmetros inválidos, um RequestId ainda será retornado, mas as informações sobre as instâncias de rede entre contas autorizadas para a instância CEN não serão retornadas.

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 da instância de rede. Você pode chamar a operação DescribeChildInstanceRegions para consultar IDs de região.	cn-hangzhou
CenId	string	Sim	O ID da instância CEN.	cen-nye53d7p3hzyu4****
ProductType	string	Sim	O tipo da instância de rede. Valores válidos: VPC: nuvem privada virtual (VPC). VBR: roteador de borda virtual (VBR). CCN: Cloud Connect Network (CCN). VPN: conexão IPsec. ECR: Express Connect Router (ECR).	VPC
MaxResults	integer	Não	Se você não especificar o parâmetro MaxResults, a paginação não é necessária. O valor de MaxResults na resposta indica o número total de entradas. Se você especificar o parâmetro MaxResults, a paginação é necessária. O valor de MaxResults especifica o número de entradas a serem retornadas por página. Valores válidos: 1 a 100. O valor de MaxResults na resposta indica o número de entradas na página atual. Recomendamos que você defina MaxResults como 20.	20
NextToken	string	Não	O token de paginação. Valores válidos: Você não precisa especificar este parâmetro na primeira solicitação ou se não existir nenhuma consulta subsequente. Se existir uma consulta subsequente, defina este parâmetro com o valor de NextToken retornado pela chamada de API anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****
ChildInstanceId	string	Não	O ID da instância da instância de rede a ser consultada.	vpc-rj9gt5nll27onu7****
ChildInstanceOwnerId	integer	Não	O ID da conta Alibaba Cloud à qual a instância de rede pertence.	1250123456123456
EnabledIpv6	boolean	Não	Especifica se o IPv6 está ativado: Este parâmetro tem efeito apenas quando ProductType está definido como "VPC". Um valor true indica que o IPv6 está ativado. Um valor false indica que o IPv6 não está ativado. Se este parâmetro for deixado vazio, os resultados não serão filtrados por este parâmetro.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	4906B209-8613-5C19-9CC9-B7A3FFDA731C
GrantRules	object
GrantRule	array<object>	As informações de autorização.
	object	As informações da instância de rede.
ChildInstanceType	string	O tipo da instância de rede. Valores válidos: VPC: nuvem privada virtual (VPC). VBR: roteador de borda virtual (VBR). CCN: Cloud Connect Network (CCN). VPN: conexão IPsec. ECR: Express Connect Router (ECR).	VPC
ChildInstanceRegionId	string	O ID da região da instância de rede.	cn-hangzhou
ChildInstanceOwnerId	integer	O ID da conta Alibaba Cloud à qual a instância de rede pertence.	1250123456123456
ChildInstanceId	string	O ID da instância da instância de rede.	vpc-bp1rgeww9mdstuuar****
CenId	string	O ID da instância CEN.	cen-nye53d7p3hzyu4****
OrderType	string	O pagador da instância de rede. Valores válidos: PayByCenOwner: As taxas de conexão do roteador de trânsito e as taxas de processamento de dados do roteador de trânsito incorridas pela instância de rede são pagas pela conta à qual a instância CEN pertence. PayByResourceOwner: As taxas de conexão do roteador de trânsito e as taxas de processamento de dados do roteador de trânsito incorridas pela instância de rede são pagas pela conta à qual a instância de rede pertence.	PayByCenOwner
EffectiveOrderType	string	O pagador efetivo da instância de rede. Valores válidos: PayByCenOwner: As taxas incorridas pela instância de rede são pagas pela conta à qual a instância CEN pertence. PayByResourceOwner: As taxas incorridas pela instância de rede são pagas pela conta à qual a instância de rede pertence.	PayByCenOwner
CenOwnerId	integer	O ID da conta Alibaba Cloud à qual a instância CEN pertence.	1210123456123456
CreateTime	integer	A hora em que a autorização foi criada. A hora é exibida em UTC no formato AAAA-MM-DDThh:mmZ.	2024-01-24T16:27Z
TotalCount	integer	O número total de entradas retornadas.	1
MaxResults	integer	Se você não especificou o parâmetro de solicitação MaxResults, a paginação não é necessária. O valor de MaxResults na resposta indica o número total de entradas. Se você especificou o parâmetro de solicitação MaxResults, a paginação é necessária. O valor de MaxResults na resposta indica o número de entradas na página atual.	20
NextToken	string	O token de paginação. Valores válidos: Se NextToken estiver vazio, não existe nenhuma consulta subsequente. Se NextToken for retornado, o valor indica o token para a próxima consulta.	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.	O parâmetro é inválido.
400	MissingParameter	Missing parameter.	Um parâmetro obrigatório está ausente.
400	InvalidParameter.RegionId	The specified Region Id is invalid.	O RegionId especificado na solicitação é inválido.
400	IllegalParam.NextToken	NextToken is illegal	O NextToken especificado na solicitação é inválido.
400	MissingParameter.RegionId	Missing RegionId parameter.	O parâmetro RegionId está ausente.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.