ListSharedTargets - Resource Management - Centro de documentación de Alibaba Cloud

Consulta una lista de principales.

Descripción de la operación

Si usted es propietario de recursos, puede consultar los principales con los que comparte sus recursos. Si usted es un principal, puede consultar los recursos compartidos de los que forma parte.

Este tema proporciona un ejemplo de cómo consultar la lista de principales para un recurso compartido que creó en la región cn-hangzhou. La respuesta muestra que compartió recursos con los principales 114240524784**** y 172050525300****.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

resourcesharing:ListSharedTargets

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceOwner	string	Sí	El propietario del recurso compartido. Self: Consulta los principales asociados con los recursos compartidos que usted creó. OtherAccounts: Consulta los recursos compartidos que otras cuentas crearon y compartieron con usted, así como los propietarios de dichos recursos compartidos.	Self
ResourceType	string	No	El tipo del recurso compartido. Para obtener más información sobre los tipos de recursos que se pueden compartir, consulte Servicios compatibles con Resource Sharing.	VSwitch
ResourceId	string	No	El ID del recurso compartido.	vsw-bp1upw03qyz8n7us9****
ResourceArn	string	No	El nombre de recurso de Alibaba Cloud (ARN) del recurso compartido.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
MaxResults	integer	No	El número máximo de entradas a devolver para una sola solicitud. Valores válidos: 1 a 100. Valor predeterminado: 20.	20
NextToken	string	No	El token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados. Si la respuesta se trunca, puede utilizar este token para iniciar otra solicitud y recuperar las entradas restantes.	TGlzdFJlc291cm****
ResourceShareIds	array	No	Los ID de los recursos compartidos. El valor de N puede ser de 1 a 5. Puede especificar hasta 5 ID de recursos compartidos.	rs-6GRmdD3X****
	string	No	El ID del recurso compartido. El valor de N puede ser de 1 a 5. Puede especificar hasta 5 ID de recursos compartidos.	rs-6GRmdD3X****
Targets	array	No	Los principales.	114240524784****
	string	No	El principal. Valores válidos: Si establece `AllowExternalTargets` en `false`, el principal puede ser el ID de un directorio de recursos, una carpeta o un miembro. Si establece `AllowExternalTargets` en `true`, el principal puede ser el ID de una cuenta de Alibaba Cloud, un directorio de recursos, una carpeta o un miembro, o el nombre de un servicio de Alibaba Cloud. Para obtener más información, consulte Métodos para compartir recursos, Ver el ID de un directorio de recursos, Ver el ID de una carpeta o Ver el ID de un miembro. El valor de N puede ser de 1 a 5. Puede agregar hasta 5 principales a la vez.	114240524784****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
NextToken	string	El token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados. Si la respuesta se trunca, puede utilizar este token para iniciar otra solicitud y recuperar las entradas restantes.	TGlzdFJlc291cm****
RequestId	string	El ID de la solicitud.	04677DCA-7C33-464B-8811-1B1DA3C3D197
SharedTargets	array<object>	La información sobre los principales.
	object	La información sobre el principal.
TargetId	string	El ID del principal o del propietario del recurso. Valores válidos: Si establece `ResourceOwner` en `Self`, este parámetro es el ID del principal. Si establece `ResourceOwner` en `OtherAccounts`, este parámetro es el ID del propietario del recurso.	114240524784****
UpdateTime	string	La hora en que se actualizó la asociación con el principal.	2020-12-07T09:16:59.905Z
CreateTime	string	La hora en que el principal se asoció con el recurso compartido.	2020-12-07T09:16:59.905Z
ResourceShareId	string	El ID del recurso compartido.	rs-6GRmdD3X****
External	boolean	Indica si el principal es una cuenta externa al directorio de recursos. Valores válidos: true false	false
TargetProperty	string	Las propiedades del principal. Por ejemplo, el período de tiempo para compartir recursos. Nota Este parámetro se devuelve solo cuando el principal es un servicio de Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "04677DCA-7C33-464B-8811-1B1DA3C3D197",
  "SharedTargets": [
    {
      "TargetId": "114240524784****",
      "UpdateTime": "2020-12-07T09:16:59.905Z",
      "CreateTime": "2020-12-07T09:16:59.905Z",
      "ResourceShareId": "rs-6GRmdD3X****",
      "External": false,
      "TargetProperty": "{\n    \"timeRange\":{\n        \"timeRangeType\":\"timeRange\",\n        \"beginAtTime\":\"00:00\",\n        \"timezone\":\"UTC+8\",\n        \"endAtTime\":\"19:59\"\n    }\n}"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter.ResourceOwner	You must specify ResourceOwner.	You must specify ResourceOwner.
400	InvalidParameter.ResourceOwner	The ResourceOwner is invalid.	The ResourceOwner parameter is invalid.
400	InvalidParameter.ResourceType	The ResourceType is invalid.	The specified ResourceType 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.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	InvalidParameter.ResourceId	The ResourceId is invalid.	The ResourceId parameter is invalid.
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.