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

Desassocia recursos compartilhados ou principais de um compartilhamento de recursos.

Descrição da operação

O proprietário de um recurso pode chamar esta API para remover recursos compartilhados ou principais de um compartilhamento de recursos.
Um principal fora do seu diretório de recursos pode chamar esta API para sair do compartilhamento de recursos. Para mais informações, consulte Sair de um compartilhamento de recursos.

Este exemplo mostra como usar a conta de gerenciamento de um diretório de recursos para remover o principal 172050525300**** do compartilhamento de recursos rs-6GRmdD3X**** na região cn-hangzhou. Esta ação interrompe o compartilhamento de recursos com esse principal.

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:DisassociateResourceShare

update

*All Resource

*

resourcesharing:RequestedResourceType
resourcesharing:ResourceArn

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceShareId	string	Sim	O ID do compartilhamento de recursos.	rs-6GRmdD3X****
Resources	array<object>	Não	Uma lista de recursos compartilhados a serem desassociados do compartilhamento de recursos.
	object	Não	Um recurso compartilhado.
ResourceType	string	Não	O tipo do recurso compartilhado. Você pode desassociar até cinco recursos compartilhados em uma única solicitação. Para obter uma lista dos tipos de recursos suportados, consulte Serviços compatíveis com o Compartilhamento de Recursos. Nota Os parâmetros `Resources.N.ResourceId` e `Resources.N.ResourceType` devem ser especificados em pares.	VSwitch
ResourceId	string	Não	O ID do recurso compartilhado. Você pode desassociar até cinco recursos compartilhados em uma única solicitação. Nota Os parâmetros `Resources.N.ResourceId` e `Resources.N.ResourceType` devem ser especificados em pares.	vsw-bp183p93qs667muql****
Targets	array	Não	Uma lista de principais a serem desassociados do compartilhamento de recursos.	172050525300****
	string	Não	O ID de um principal. Você pode desassociar até cinco principais em uma única solicitação.	172050525300****
ResourceArns	array	Não	Uma lista dos Alibaba Cloud Resource Names (ARNs) dos recursos compartilhados. Você pode desassociar até cinco recursos compartilhados em uma única solicitação.
	string	Não	O Alibaba Cloud Resource Name (ARN) do recurso compartilhado. Nota Para obter o formato de um ARN, consulte Serviços compatíveis com o Compartilhamento de Recursos.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceOwner	string	Não	O proprietário do compartilhamento de recursos. Valores válidos: `Self` (padrão): O compartilhamento de recursos pertence à conta atual. Use este valor quando o proprietário de um recurso desassociar recursos compartilhados ou principais de um compartilhamento de recursos dentro de um Diretório de Recursos. `OtherAccounts`: O compartilhamento de recursos pertence a outra conta. Use este valor quando um principal sair de um compartilhamento de recursos criado por uma conta fora do seu Diretório de Recursos.	Self

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	95230BC9-A8E8-4493-96BD-4F0C758E37F8
ResourceShareAssociations	array<object>	As associações de recursos compartilhados ou principais com o compartilhamento de recursos.
	object	Uma associação de um recurso compartilhado ou principal com o compartilhamento de recursos.
UpdateTime	string	A hora em que a associação foi atualizada pela última vez. Para esta operação, isso indica a hora da desassociação. O significado varia com base no `AssociationType`: Se o `AssociationType` for `Resource`, esta é a hora em que o recurso foi desassociado. Se o `AssociationType` for `Target`, esta é a hora em que o principal foi desassociado.	2020-12-04T09:40:45.556Z
ResourceArn	string	O Alibaba Cloud Resource Name (ARN) do recurso compartilhado. Nota Este parâmetro é retornado apenas quando o `AssociationType` é `Resource`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	O nome do compartilhamento de recursos.	test
CreateTime	string	A hora em que a associação foi criada. O significado varia com base no `AssociationType`: Se o `AssociationType` for `Resource`, esta é a hora em que o recurso foi associado. Se o `AssociationType` for `Target`, esta é a hora em que o principal foi associado.	2020-12-04T09:40:41.250Z
EntityType	string	O tipo da entidade. Valores válidos: Se a entidade for um recurso, este é o tipo de recurso. Para mais informações, consulte Serviços compatíveis com o Compartilhamento de Recursos. Se a entidade for um principal, o valor é `Account`.	Account
ResourceShareId	string	O ID do compartilhamento de recursos.	rs-6GRmdD3X****
AssociationStatusMessage	string	O motivo pelo qual a desassociação falhou.	The Resources is invalid.
AssociationType	string	O tipo de associação. Valores válidos: `Resource`: A entidade é um recurso. `Target`: A entidade é um principal.	Target
AssociationStatus	string	O status da associação. Valores válidos: `Associating`: A entidade está sendo associada. `Associated`: A entidade está associada. `Failed`: A associação falhou. `Disassociating`: A entidade está sendo desassociada. `Disassociated`: A entidade está desassociada. Nota O sistema exclui automaticamente os registros nos estados `Failed` e `Disassociated` dentro de 48 a 96 horas.	Disassociating
TargetProperty	string	As propriedades do principal, como o período de tempo para compartilhamento de recursos. Nota Este parâmetro é retornado apenas quando o principal é um serviço da Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
EntityId	string	O ID da entidade. Seu valor varia com base no `AssociationType`: Se o `AssociationType` for `Resource`, o valor deste parâmetro é o ID do recurso. Se o `AssociationType` for `Target`, este é o ID do Diretório de Recursos, da Pasta ou do Membro.	172050525300****
ResourceProperty	string	As propriedades do recurso.	{"sharePrincipals":true,"shareTagOptions":false}

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "95230BC9-A8E8-4493-96BD-4F0C758E37F8",
  "ResourceShareAssociations": [
    {
      "UpdateTime": "2020-12-04T09:40:45.556Z",
      "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
      "ResourceShareName": "test",
      "CreateTime": "2020-12-04T09:40:41.250Z",
      "EntityType": "Account",
      "ResourceShareId": "rs-6GRmdD3X****",
      "AssociationStatusMessage": "The Resources is invalid.",
      "AssociationType": "Target",
      "AssociationStatus": "Disassociating",
      "TargetProperty": "{\n    \"timeRange\":{\n        \"timeRangeType\":\"timeRange\",\n        \"beginAtTime\":\"00:00\",\n        \"timezone\":\"UTC+8\",\n        \"endAtTime\":\"19:59\"\n    }\n}",
      "EntityId": "172050525300****",
      "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.ResourceShareId	You must specify ResourceShareId.	You must specify ResourceShareId.
400	InvalidParameter.ResourceShareId	The ResourceShareId is invalid.	The ResourceShareId parameter is invalid.
400	InvalidParameter.Resources	The Resources is invalid.	The specified shared resource is invalid.
400	InvalidParameter.Resources.Duplicate	The Resources contains duplicate values.	The specified Resources parameter contains duplicate values.
400	InvalidParameter.Resources.Length	The maximum number of Resources exceeds 5.	The number of specified shared resources cannot exceed 5.
400	InvalidParameter.Targets	The Targets is invalid.	The specified Targets parameter is invalid.
400	InvalidParameter.Targets.Duplicate	The Targets contains duplicate values.	The specified Targets parameter contains duplicate values.
400	InvalidParameter.Targets.Length	The maximum number of Targets exceeds 5.	The number of Targets values cannot exceed 5.
400	ResourceAndTargetBothEmpty	Either a resource or a shared target must be specified.	You must specify a resource or a resource account.
400	DisassociateInvalid	You can not disassociate unassociated resource or target.	The disassociation operation is not supported for an entity that is not associated with the resource share.
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	InvalidParameter.ResourceType	The ResourceType is invalid.	The specified ResourceType parameter is invalid.
400	InvalidParameter.ResourceArns	The ResourceArns is invalid.	The ResourceArns parameter is invalid.
400	InvalidParameter.ResourceArns.Duplicate	The ResourceArns contains duplicate values.	The ResourceArns contains duplicate values.
400	InvalidParameter.ResourceArns.Length	The ResourceArns beyond the length limit.	The maximum number of ResourceArns exceeds 5.
400	InvalidParameter.ResourceConflict	Both Resources and ResourceArns cannot be specified simultaneously. Please provide only one of these parameters.	Both Resources and ResourceArns cannot be specified simultaneously. Please provide only one of these parameters.
400	NotSupport.ResourceType.ResourcesParameter	The Resources parameter does not support this resource type. Please use ResourceArns instead.	The Resources parameter does not support this resource type. Please use ResourceArns instead.
404	EntityNotExists.ResourceShare	The resource share does not exist in the current account.	The resource share does not exist in the current account.
409	AccountNotInResourceDirectory	The account is not a master or a member of a resource directory.	The specified Targets value is not a member in the resource directory.
409	ResourceShareStatusMismatchAction	The status of the resource share does not allow the specified operation.	The status of the resource share does not allow the specified operation.
409	DisassociateConflict	You cannot perform the operation while association is already in progress.	The association operation is not supported while an association is being performed.
409	LeavingFailed.Account	The account was added to the resource share automatically by resoucre directory.	The current account is a principal of a resource share and cannot proactively exit the resource share. Contact the owner of the resource share to remove the account from the resource share.
409	LeavingFailed.ResourceType	The resource share contains resources of the resource types that dont support this action.	The resource share contains resources that cannot proactively exit the resource share. Contact the owner of the resource share to remove the current account from the resource share.
409	ExternalTargetWithdrawConflict	Existing internal association task in resource directory when disassociating with resource share.	The current account is a principal of a resource share and cannot proactively exit the resource share. Contact the owner of the resource share to remove the account from the resource share.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.