ListResourceRelations - Cloud Config: Central de Documentação do Alibaba Cloud

Consulta uma lista de recursos associados a um recurso específico.

Descrição da operação

Para obter informações sobre os serviços da Alibaba Cloud e os tipos de recursos compatíveis com o Cloud Config, consulte Serviços da Alibaba Cloud e tipos de recursos compatíveis com o Cloud Config.\n\nEste tópico fornece um exemplo de como consultar as informações sobre os discos anexados a uma instância do Elastic Compute Service (ECS) chamada i-j6cajg9yrfoh4sas**** que foi criada pela conta atual da Alibaba Cloud na região da China (Xangai).

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

config:ListResourceRelations

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceId	string	Sim	O ID do recurso.	i-j6cajg9yrfoh4sas****
ResourceType	string	Sim	O tipo do recurso.	ACS::ECS::Instance
Region	string	Sim	O ID da região na qual o recurso reside.	cn-shanghai
NextToken	string	Não	O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Você não precisa especificar este parâmetro na primeira solicitação. Você deve especificar o token obtido na consulta anterior como o valor de NextToken.	C2DjqMYSy0is7zSMGf21****
MaxResults	integer	Não	O número máximo de entradas a serem retornadas em uma solicitação. Valores válidos: 1 a 1000.	10
TargetResourceType	string	Não	O tipo do recurso associado ao objeto.	ACS::ECS::Disk
TargetResourceId	string	Não	O ID do recurso associado ao objeto.	d-j6c8k731qbrc7fxi****
RelationType	string	Não	O tipo de relação entre o recurso e o objeto. Valores válidos:\n- IsContained: O objeto está incluído como parte do recurso.\n- IsAttachedTo: O objeto é anexado ao recurso.\n- IsAssociatedIn: O objeto está associado ao recurso.\n- Contains: O objeto contém o recurso. Valores válidos: IsContained : IsAttachedTo : IsAssociatedIn : Contains :	IsAttachedTo

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	6525F8DE-5A8B-5AD3-A241-BBF5A259E5B2
ResourceRelations	object	O resultado da relação.
ResourceRelationList	array<object>	Uma matriz que contém as relações.
	object
AccountId	integer	The ID of the Alibaba Cloud account to which the resource belongs.	100931896542****
SourceResourceType	string	The type of the resource.	ACS::ECS::Instance
SourceResourceRegionId	string	The ID of the region in which the resource resides.	cn-shanghai
SourceResourceId	string	The resource ID.	i-j6cajg9yrfoh4sas****
TargetResourceType	string	The type of the associated resource.	ACS::ECS::Disk
TargetResourceId	string	The ID of the associated resource.	d-j6c8k731qbrc7fxi****
RelationType	string	The type of the relationship between the resource and the object. Valid values: IsContained: The object is included as part of the resource. IsAttachedTo: The object is added to the resource. IsAssociatedIn: The object is associated with the resource. Contains: The object contains the resource. Valores válidos: IsContained : IsAttachedTo : IsAssociatedIn : Contains :	IsAttachedTo
NextToken	string	O token usado para iniciar a próxima solicitação.	C2DjqMYSy0is7zSMGf21****
MaxResults	integer	O número máximo de entradas retornadas em cada página.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "6525F8DE-5A8B-5AD3-A241-BBF5A259E5B2",
  "ResourceRelations": {
    "ResourceRelationList": [
      {
        "AccountId": 0,
        "SourceResourceType": "ACS::ECS::Instance",
        "SourceResourceRegionId": "cn-shanghai",
        "SourceResourceId": "i-j6cajg9yrfoh4sas****",
        "TargetResourceType": "ACS::ECS::Disk",
        "TargetResourceId": "d-j6c8k731qbrc7fxi****",
        "RelationType": "IsAttachedTo"
      }
    ],
    "NextToken": "C2DjqMYSy0is7zSMGf21****",
    "MaxResults": 10
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	NoPermission	You are not authorized to perform this operation.
400	MemberNotBelongToMaster	The specified member does not belong to your organization.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.