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

Cria um compartilhamento de recursos.

Descrição da operação

O Compartilhamento de Recursos do Alibaba Cloud permite que você compartilhe recursos da sua conta com um ou mais principais. Para obter mais informações, consulte Visão geral do Compartilhamento de Recursos.

Este exemplo mostra como usar a conta de gerenciamento de um Diretório de Recursos para criar um compartilhamento de recursos chamado test na região cn-hangzhou e compartilhar o vSwitch vsw-bp183p93qs667muql**** com o membro 172050525300****.

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

create

*All Resource

*

resourcesharing:RequestedAllowExternalTargets
resourcesharing:Target
resourcesharing:RequestedResourceType
resourcesharing:ResourceArn

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceShareName	string	Sim	O nome do compartilhamento de recursos. O nome deve ter de 1 a 50 caracteres. Pode conter letras, dígitos, caracteres chineses, pontos (.), sublinhados (_) e hifens (-).	test
Resources	array<object>	Não	Uma lista de recursos compartilhados.
	object	Não	Um recurso compartilhado.
ResourceId	string	Não	O ID do recurso compartilhado. Você pode adicionar até cinco recursos compartilhados por vez. Nota Especifique os parâmetros Resources.N.ResourceId e Resources.N.ResourceType em pares.	vsw-bp183p93qs667muql****
ResourceType	string	Não	O tipo do recurso compartilhado. Você pode adicionar até cinco recursos compartilhados por vez. Para obter uma lista dos tipos de recursos suportados, consulte Serviços compatíveis com o Compartilhamento de Recursos. Nota Especifique os parâmetros Resources.N.ResourceId e Resources.N.ResourceType em pares.	VSwitch
Targets	array	Não	Uma lista de principais.	172050525300****
	string	Não	O ID de um principal. Os valores válidos dependem da configuração de AllowExternalTargets: Se AllowExternalTargets estiver definido como false, o valor poderá ser o ID de um Diretório de Recursos, uma Pasta ou um Membro. Se AllowExternalTargets estiver definido como true, o valor poderá ser o ID de uma Conta Alibaba Cloud, um Diretório de Recursos, uma Pasta, um Membro ou um serviço Alibaba Cloud. Para obter mais informações, consulte Métodos usados para compartilhar recursos, Visualizar o ID de um diretório de recursos, Visualizar o ID de uma pasta ou Visualizar o ID de um membro. Você pode adicionar até cinco principais por vez.	172050525300****
ResourceArns	array	Não	Os Alibaba Cloud Resource Names (ARNs) dos recursos compartilhados. Você pode adicionar até cinco recursos compartilhados por vez.
	string	Não	O ARN do recurso compartilhado. Nota Para o formato de um ARN de recurso, consulte Serviços compatíveis com o Compartilhamento de Recursos.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
PermissionNames	array	Não	O nome da permissão. Se não for especificado, o sistema anexa a permissão padrão para o tipo de recurso. Para obter detalhes, consulte Biblioteca de Permissões.
	string	Não	O nome da permissão. Se não for especificado, o sistema anexa a permissão padrão para o tipo de recurso. Para obter detalhes, consulte Biblioteca de Permissões.	AliyunRSDefaultPermissionVSwitch
AllowExternalTargets	boolean	Não	Especifica se deve ser permitido o compartilhamento com contas fora do seu diretório de recursos. Valores válidos: false (padrão): Os recursos podem ser compartilhados apenas com contas dentro do seu diretório de recursos. true: Os recursos podem ser compartilhados com qualquer conta Alibaba Cloud.	false
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aekz5nlvlak****
TargetProperties	array<object>	Não	As propriedades do principal. Nota Este parâmetro está disponível apenas quando o principal é um serviço Alibaba Cloud.
	object	Não	As propriedades do principal. Nota Este parâmetro está disponível apenas quando o principal é um serviço Alibaba Cloud.
Property	string	Não	A propriedade do principal. Por exemplo, você pode especificar um intervalo de tempo para o compartilhamento de recursos. Valores válidos para timeRangeType: timeRange: um intervalo de tempo especificado. day: o dia inteiro. Nota Especifique os parâmetros TargetProperties.N.TargetId e TargetProperties.N.Property em pares.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
TargetId	string	Não	O ID do principal. Nota Especifique os parâmetros TargetProperties.N.TargetId e TargetProperties.N.Property em pares.	172050525300****
ResourceProperties	array<object>	Não	Uma lista de propriedades de recursos.
	object	Não	Uma propriedade de recurso.
Property	string	Não	A propriedade do recurso.	{"sharePrincipals":true,"shareTagOptions":false}
ResourceArn	string	Não	O ARN do recurso.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
Tag	array<object>	Não	As tags do compartilhamento de recursos. Você pode adicionar no máximo 20 tags.
	object	Não	Uma tag.
Key	string	Não	A chave da tag. Nota A chave da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	k1
Value	string	Não	O valor da tag. Nota O valor da tag pode ter até 128 caracteres. Não pode começar com acs: e não pode conter http:// ou https://.	v1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	2C3FA051-61DC-4F3E-81E9-E4830524DF4B
ResourceShare	object	As informações sobre o compartilhamento de recursos.
AllowExternalTargets	boolean	Indica se as contas fora do diretório de recursos têm permissão para acessar os recursos compartilhados. Valores válidos: false: O compartilhamento com contas fora do diretório de recursos não é permitido. true: O compartilhamento com qualquer conta é permitido.	false
CreateTime	string	A hora em que o compartilhamento de recursos foi criado.	2020-12-03T08:02:22.413Z
ResourceShareId	string	O ID do compartilhamento de recursos.	rs-qSkW1HBY****
ResourceShareName	string	O nome do compartilhamento de recursos.	test
ResourceShareOwner	string	O proprietário do compartilhamento de recursos.	151266687691****
ResourceShareStatus	string	O status do compartilhamento de recursos. Valores válidos: Active: O compartilhamento de recursos está ativado. Pending: O compartilhamento de recursos está aguardando o convidado confirmar o convite. Deleting: O compartilhamento de recursos está sendo excluído. Deleted: O compartilhamento de recursos foi excluído. Nota Um compartilhamento de recursos no estado Deleted é removido automaticamente pelo sistema em 48 a 96 horas.	Active
UpdateTime	string	A hora em que o compartilhamento de recursos foi atualizado pela última vez.	2020-12-03T08:02:22.413Z

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2C3FA051-61DC-4F3E-81E9-E4830524DF4B",
  "ResourceShare": {
    "AllowExternalTargets": false,
    "CreateTime": "2020-12-03T08:02:22.413Z",
    "ResourceShareId": "rs-qSkW1HBY****",
    "ResourceShareName": "test",
    "ResourceShareOwner": "151266687691****",
    "ResourceShareStatus": "Active",
    "UpdateTime": "2020-12-03T08:02:22.413Z"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.ResourceShareName	The ResourceShareName is invalid.	The ResourceShareName parameter is invalid.
400	InvalidParameter.ResourceShareName.Length	The maximum length of ResourceShareName exceeds 50 characters.	The length of ResourceShareName cannot exceed 50 characters.
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	InvalidTarget	The shared target does not exist in the resource directory.	The specified Targets value is not a member in the resource directory.
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	MissingParameter.ResourceShareName	You must specify ResourceShareName.	The ResourceShareName parameter is missing.
400	InvalidParameter.ResourceType	The ResourceType is invalid.	The specified ResourceType parameter is invalid.
400	InvalidParameter.PermissionNames.Duplicate	The PermissionNames duplicate values.	Duplicate values are specified for the PermissionNames parameter.
400	InvalidParameter.PermissionNames.Length	The maximum length of PermissionNames exceeds quota limit.	The length of the value specified for the PermissionNames parameter exceeds the limit.
400	InvalidParameter.TargetProperties	The TargetProperties is invalid.	The TargetProperties is invalid.
400	InvalidParameter.TargetProperties.Duplicate	The TargetProperties contains duplicate values.	TargetProperties contains duplicate parameters.
400	InvalidParameter.TargetProperties.Length	The TargetProperties beyond the length limit.	The TargetProperties beyond the length limit.
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.
400	InvalidParameter.ResourceProperties	The ResourceProperties is invalid.	The ResourceProperties is invalid.
400	InvalidParameter.ResourceProperties.Duplicate	The ResourceProperties contains duplicate values.	The ResourceProperties contains duplicate values.
400	InvalidParameter.ResourceProperties.Length	The ResourceProperties beyond the length limit.	The ResourceProperties beyond the length limit.
400	NotSupport.ResourceProperty	The resource type does not support resource property.	The resource type does not support resource property.
404	EntityNotExists.Permission	The resource share permission does not exist.	You do not have the required permissions.
409	NotEnableSharingWithResourceDirectory	You have not enabled sharing with your Resource Directory.	You have not enabled sharing with Resource Directory.
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	QuotaExceeded.ResourceShare.Count	The maximum number of ResourceShare exceeds the limit.	The maximum number of ResourceShare exceeds the limit.
409	EntityAlreadyExists.ResourceShare	The specified resource share ID already exists.	The specified resource share ID already exists.
409	QuotaExceeded.SharedResource.Count	The maximum number of shared resources per account exceeds the limit.	The maximum number of Resources values per account is exceeded.
409	ShareWithYourself	You cannot share resources with yourself.	You cannot share resources with yourself.
409	NotManagementAccount	Only the management account of the service is allowed to share such resources.	Only the management account of the resource directory can be used to share the current type of resource. If you still want to use the current account, contact the owner of the management account to configure the current account as a delegated administrator account of the trusted service to which the resource belongs.
409	QuotaExceeded.PendingInvitations	The maximum number of pending invitations exceeds the limit.	The number of invitations exceeds the upper limit.
409	InvalidTarget.LegalEntityMismatch	The target account does not have the same legal entity as the resource owner account.	The enterprise name of the principal is inconsistent with that of the resource owner.
409	ExternalTargetsNotAllowed.ResourceType	The resource share includes resource types that cannot be shared with accounts outside the resource directory.	The resource share contains resources that do not support this operation.
409	InvalidTarget.SiteMismatch	Cross-site resource sharing is not supported.	The principal and resource owner are registered at different sites.
409	NotSupport.Service.ExistInOtherResourceShare	The resource type has been shared to the target service through other resourceShare. Please share it in the same resourceShare.
409	NotSupport.Service.AssociateConflict	The same resource cannot be shared repeatedly to the target service.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.