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

Consulta los recursos que usted comparte con otras cuentas o los recursos que otras cuentas comparten con usted.

Descripción de la operación

Este ejemplo muestra cómo consultar los recursos que compartió en la región cn-hangzhou. La respuesta indica que solo compartió un recurso, que es una VSwitch con el ID vsw-bp1upw03qyz8n7us9**** en el recurso compartido rs-6GRmdD3X****.

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

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceOwner	string	Sí	El propietario del recurso compartido. Valores válidos: Self: Consulta los recursos que usted compartió con otras cuentas desde sus recursos compartidos. OtherAccounts: Consulta los recursos que otras cuentas compartieron con usted.	Self
ResourceType	string	No	El tipo de recurso compartido. Para obtener más información sobre los tipos de recursos que se pueden compartir, consulte Servicios compatibles con Resource Sharing.	VSwitch
Target	string	No	El ID del principal o del propietario del recurso. Si establece `ResourceOwner` en `Self`, este parámetro es el ID de un principal. Si establece `ResourceOwner` en `OtherAccounts`, este parámetro es el ID de un propietario de recurso.	172050525300****
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	El ID del recurso compartido. El valor de N varía de 1 a 5. Puede especificar hasta 5 ID de recursos compartidos.	rs-6GRmdD3X****
	string	No	El ID del recurso compartido.	rs-6GRmdD3X****
ResourceIds	array	No	El ID del recurso compartido. El valor de N varía de 1 a 5. Puede especificar hasta 5 ID de recursos compartidos.	vsw-bp1upw03qyz8n7us9****
	string	No	El ID del recurso compartido.	vsw-bp1upw03qyz8n7us9****
ResourceArns	array	No	Una lista de nombres de recursos de Alibaba Cloud (ARN) de los recursos compartidos. El valor de N varía de 1 a 5. Puede especificar hasta 5 recursos compartidos.
	string	No	El ARN del recurso compartido. Nota Para obtener más información sobre el formato de un ARN de recurso, consulte Servicios compatibles con Resource Sharing.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**

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
SharedResources	array<object>	La información sobre los recursos compartidos.
	object	La información sobre el recurso compartido.
UpdateTime	string	La hora en que se actualizó el recurso compartido.	2020-12-07T07:39:02.921Z
ResourceType	string	El tipo de recurso compartido. Para obtener más información sobre los tipos de recursos que se pueden compartir, consulte Servicios compatibles con Resource Sharing.	VSwitch
CreateTime	string	La hora en que el recurso se asoció al recurso compartido.	2020-12-07T07:39:02.921Z
ResourceShareId	string	El ID del recurso compartido.	rs-6GRmdD3X****
ResourceArn	string	El ARN del recurso compartido.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceStatus	string	El estado del recurso compartido. Este parámetro se devuelve solo cuando consulta recursos que fueron compartidos con usted. Este parámetro no se devuelve cuando consulta recursos que usted compartió. Valores válidos: Available: El recurso está disponible. ZonalResourceInaccessible: El recurso no está disponible en la zona actual. LimitExceeded: El recurso no está disponible porque se excedió la cuota. Unavailable: El recurso no está disponible.	Available
ResourceStatusMessage	string	El motivo por el cual falló la asociación.	El motivo del fallo de la asociación
ResourceId	string	El ID del recurso compartido.	vsw-bp1upw03qyz8n7us9****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "04677DCA-7C33-464B-8811-1B1DA3C3D197",
  "SharedResources": [
    {
      "UpdateTime": "2020-12-07T07:39:02.921Z",
      "ResourceType": "VSwitch",
      "CreateTime": "2020-12-07T07:39:02.921Z",
      "ResourceShareId": "rs-6GRmdD3X****",
      "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
      "ResourceStatus": "Available",
      "ResourceStatusMessage": "The reason for the association failure. ",
      "ResourceId": "vsw-bp1upw03qyz8n7us9****"
    }
  ]
}

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.ResourceIds	The ResourceIds is invalid.	The specified ResourceIds parameter is invalid.
400	InvalidParameter.ResourceIds.Duplicate	The specified ResourceId contains duplicate values.	The specified ResourceIds parameter contains duplicate values.
400	InvalidParameter.ResourceIds.Length	The maximum number of ResourceIds (5) is exceeded.	The number of specified ResourceIds values cannot exceed 5.
400	InvalidParameter.Target	The Target is invalid.	The Target parameter is invalid.
400	InvalidParameter	The specified parameter is invalid.	The specified 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	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.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.