ListResourceShareAssociations - Resource Management: Central de Documentação do Alibaba Cloud

Lista os recursos ou principais associados a um compartilhamento de recursos.

Descrição da operação

Este exemplo mostra como consultar registros de associação de recursos compartilhados em compartilhamentos de recursos criados pela conta atual na região China (Hangzhou). A resposta mostra registros para os seguintes dois recursos compartilhados:

Um recurso compartilhado VSwitch, vsw-bp1upw03qyz8n7us9****, foi associado ao compartilhamento de recursos rs-6GRmdD3X****. O recurso está no estado Associated, o que significa que está ativamente compartilhado.
Um recurso compartilhado VSwitch, vsw-bp183p93qs667muql****, foi desassociado do compartilhamento de recursos rs-6GRmdD3X****. O recurso está no estado Disassociated, o que significa que não está mais compartilhado.

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

resourcesharing:ListResourceShareAssociations

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceId	string	Não	O ID do recurso. Nota Este parâmetro não está disponível quando AssociationType é definido como Target.	vsw-bp183p93qs667muql****
ResourceArn	string	Não	O Alibaba Cloud Resource Name (ARN) do recurso. Nota Este parâmetro não está disponível quando AssociationType é definido como Target.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
Target	string	Não	O ID do principal. Nota Este parâmetro não está disponível quando AssociationType é definido como Resource.	172050525300****
AssociationType	string	Sim	O tipo da associação. Valores válidos: Resource: Retorna associações com recursos compartilhados. Target: Retorna associações com principais.	Resource
AssociationStatus	string	Não	O status da associação. Valores válidos: Associating: A associação está em andamento. Associated: A associação está estabelecida. Failed: A associação falhou. Disassociating: A desassociação está em andamento. Disassociated: A associação foi removida. Nota O sistema exclui automaticamente os registros no estado Failed ou Disassociated dentro de 48 a 96 horas.	Associated
MaxResults	integer	Não	O número máximo de entradas a serem retornadas por página. Valores válidos: 1 a 100. Valor padrão: 20.	20
NextToken	string	Não	O token para a próxima página de resultados. Se a resposta anterior foi truncada, inclua este token para recuperar os resultados restantes.	TGlzdFJlc291cm****
ResourceShareIds	array	Não	Os IDs dos compartilhamentos de recursos. Você pode especificar até 5 IDs de compartilhamentos de recursos.	rs-6GRmdD3X****
	string	Não	Um ID de compartilhamento de recursos.	rs-6GRmdD3X****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
NextToken	string	O token para recuperar a próxima página de resultados. NextToken é retornado apenas se os resultados forem truncados. Se este parâmetro não for retornado, todos os resultados foram recuperados.	TGlzdFJlc291cm****
RequestId	string	O ID da solicitação.	11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB
ResourceShareAssociations	array<object>	Uma lista de associações.
	array<object>	Detalhes da associação.
UpdateTime	string	A hora da última atualização da associação. Se AssociationType for Resource, esta é a hora em que o recurso foi atualizado. Se AssociationType for Target, esta é a hora em que o principal foi atualizado.	2020-12-07T07:39:02.920Z
EntityId	string	O ID da entidade associada. Se AssociationType for Resource, este é o ID do recurso. Se AssociationType for Target, este é o ID do principal.	vsw-bp1upw03qyz8n7us9****
ResourceArn	string	O Alibaba Cloud Resource Name (ARN) do recurso associado. Nota Retornado apenas se AssociationType for Resource.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	O nome do compartilhamento de recursos.	example
CreateTime	string	A hora em que a associação foi criada. Se AssociationType for Resource, esta é a hora em que o recurso foi associado ao compartilhamento de recursos. Se AssociationType for Target, esta é a hora em que o principal foi associado ao compartilhamento de recursos.	2020-12-07T07:39:01.818Z
EntityType	string	O tipo da entidade associada. Quando a entidade é um recurso (AssociationType é Resource), este valor é o tipo de recurso. Para mais informações, consulte Serviços compatíveis com o Compartilhamento de Recursos. Quando a entidade é um principal (AssociationType é Target), este valor é Account.	VSwitch
ResourceShareId	string	O ID do compartilhamento de recursos.	rs-6GRmdD3X****
AssociationStatusMessage	string	O motivo da falha na associação.	The reason for the association failure.
AssociationType	string	O tipo da associação. Valores válidos: Resource: A entidade é um recurso. Target: A entidade é um principal.	Resource
AssociationStatus	string	O status da associação. Valores válidos: Associating: A associação está em andamento. Associated: A associação está concluída. Failed: A associação falhou. Disassociating: A desassociação está em andamento. Disassociated: A desassociação está concluída. Nota O sistema exclui automaticamente as associações no estado Failed ou Disassociated dentro de 48 a 96 horas.	Failed
External	boolean	Indica se o principal é uma conta Alibaba Cloud que não é membro do seu Diretório de Recursos. Valores válidos: true: O principal é uma conta externa. false: O principal é um membro do seu Diretório de Recursos.	false
AssociationFailedDetails	array<object>	Detalhes de uma associação ou desassociação com falha.
	object	Detalhes da operação com falha.
Status	string	This parameter is deprecated. Use `FailureReason` instead.	无
StatusMessage	string	This parameter is deprecated. Use `FailureDescription` instead.	无
AssociateType	string	This parameter is deprecated. Use `OperationType` instead.	无
ResourceArn	string	The ARN of the associated resource. Nota Returned only if `AssociationType` is `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
EntityType	string	The type of the entity. If the entity is a resource, this value is the resource type. For more information, see Services that work with Resource Sharing. If the entity is a principal, this value can be `ResourceDirectory`, `Folder`, `Account`, or `Service`.	Account
FailureReason	string	The reason for the failed association or disassociation. Valid values: Unavailable: The sharing operation failed because the resource is unavailable. For example, the resource may have been deleted. LimitExceeded: The resource has been shared with the maximum number of principals allowed by the Quota. ZonalResourceInaccessible: The resource is not accessible from the current Region. InternalError: An internal server error occurred. UnsupportedOperation: The operation is not supported.	Unavailable
FailureDescription	string	A detailed description of the association or disassociation failure.	You cannot access the specified resource at this time.
OperationType	string	The type of the operation that failed. Valid values: `Associate` `Disassociate`	Associate
EntityId	string	The ID of the entity in the failed association. If the operation involved associating a resource, this is the ID of the principal for which the association failed. If the operation involved associating a principal, this is the ID of the resource for which the association failed.	172050525300****
TargetProperty	string	As propriedades do principal, como o período de tempo para compartilhamento de recursos. Os valores válidos para timeRangeType incluem: timeRange: um período de tempo especificado. day: o dia inteiro. Nota Retornado apenas se o principal for um serviço Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
ResourceProperty	string	As propriedades relacionadas ao compartilhamento do recurso.	{"sharePrincipals":true,"shareTagOptions":false}

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB",
  "ResourceShareAssociations": [
    {
      "UpdateTime": "2020-12-07T07:39:02.920Z",
      "EntityId": "vsw-bp1upw03qyz8n7us9****",
      "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
      "ResourceShareName": "example",
      "CreateTime": "2020-12-07T07:39:01.818Z",
      "EntityType": "VSwitch",
      "ResourceShareId": "rs-6GRmdD3X****",
      "AssociationStatusMessage": "The reason for the association failure. ",
      "AssociationType": "Resource",
      "AssociationStatus": "Failed",
      "External": false,
      "AssociationFailedDetails": [
        {
          "Status": "无",
          "StatusMessage": "无",
          "AssociateType": "无",
          "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
          "EntityType": "Account",
          "FailureReason": "Unavailable",
          "FailureDescription": "You cannot access the specified resource at this time.",
          "OperationType": "Associate",
          "EntityId": "172050525300****"
        }
      ],
      "TargetProperty": "{\n    \"timeRange\":{\n        \"timeRangeType\":\"timeRange\",\n        \"beginAtTime\":\"00:00\",\n        \"timezone\":\"UTC+8\",\n        \"endAtTime\":\"19:59\"\n    }\n}",
      "ResourceProperty": "{\"sharePrincipals\":true,\"shareTagOptions\":false}"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter.AssociationType	You must specify AssociationType.	You must specify AssociationType.
400	InvalidParameter.AssociationType	The AssociationType is invalid.	The AssociationType parameter is invalid.
400	InvalidParameter.AssociationStatus	The AssociationStatus is invalid.	The AssociationStatus parameter is invalid.
400	InvalidParameter.MaxResults	The MaxResults is invalid.	The MaxResults parameter is invalid.
400	InvalidParameter.NextToken	The NextToken is invalid.	The NextToken parameter is invalid.
400	InvalidParameter.NextToken.Length	The maximum length of NextToken exceeds 256 characters.	The length of NextToken cannot exceed 256 characters.
400	InvalidParameter.ResourceShareIds	The ResourceShareIds is invalid.	The ResourceShareIds parameter is invalid.
400	InvalidParameter.ResourceShareIds.Duplicate	The ResourceShareIds contains duplicate values.	The ResourceShareIds parameter contains duplicate values.
400	InvalidParameter.ResourceShareIds.Length	The maximum length of ResourceShareIds exceeds 5 characters.	The number of ResourceShareIds values cannot exceed 5.
400	InvalidParameter.Target	The Target is invalid.	The Target parameter is invalid.
400	InvalidParameter.ResourceId	The ResourceId is invalid.	The ResourceId parameter is invalid.
400	ConflictedAssociationType	The specified ResourceId or Target conflicts with AssociationType.	The specified parameter conflicts with AssociationType.
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	InvalidParameter.ResourceArn	The ResourceArn is invalid.	The ResourceArn is invalid.
400	InvalidParameter.ResourceConflict	Both ResourceId and ResourceArn cannot be specified simultaneously. Please provide only one of these parameters.	Both ResourceId and ResourceArn cannot be specified simultaneously. Please provide only one of these parameters.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.