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

Enumera los recursos o principales que están asociados con un recurso compartido.

Descripción de la operación

Este ejemplo muestra cómo consultar los registros de asociación de recursos compartidos dentro de los recursos compartidos creados por la cuenta actual en la región China (Hangzhou). La respuesta muestra registros para los siguientes dos recursos compartidos:

Un recurso compartido VSwitch, vsw-bp1upw03qyz8n7us9****, se asoció con el recurso compartido rs-6GRmdD3X****. El recurso está en estado Associated, lo que significa que se comparte activamente.
Un recurso compartido VSwitch, vsw-bp183p93qs667muql****, se desasoció del recurso compartido rs-6GRmdD3X****. El recurso está en estado Disassociated, lo que significa que ya no se comparte.

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

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceId	string	No	El ID del recurso. Nota Este parámetro no está disponible cuando `AssociationType` se establece en `Target`.	vsw-bp183p93qs667muql****
ResourceArn	string	No	El nombre de recurso de Alibaba Cloud (ARN) del recurso. Nota Este parámetro no está disponible cuando `AssociationType` se establece en `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
Target	string	No	El ID del principal. Nota Este parámetro no está disponible cuando `AssociationType` se establece en `Resource`.	172050525300****
AssociationType	string	Sí	El tipo de asociación. Valores válidos: `Resource`: Devuelve asociaciones con recursos compartidos. `Target`: Devuelve asociaciones con principales.	Resource
AssociationStatus	string	No	El estado de la asociación. Valores válidos: `Associating`: La asociación está en curso. `Associated`: La asociación se ha establecido. `Failed`: La asociación falló. `Disassociating`: La desasociación está en curso. `Disassociated`: La asociación se ha eliminado. Nota El sistema elimina automáticamente los registros en estado `Failed` o `Disassociated` dentro de 48 a 96 horas.	Associated
MaxResults	integer	No	El número máximo de entradas que se devolverán por página. Valores válidos: 1 a 100. Valor predeterminado: 20.	20
NextToken	string	No	El token para la siguiente página de resultados. Si la respuesta anterior se truncó, incluya este `token` para recuperar los resultados restantes.	TGlzdFJlc291cm****
ResourceShareIds	array	No	Los ID de los recursos compartidos. Puede especificar hasta 5 ID de recursos compartidos.	rs-6GRmdD3X****
	string	No	Un ID de recurso compartido.	rs-6GRmdD3X****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
NextToken	string	El token para recuperar la siguiente página de resultados. `NextToken` se devuelve solo si los resultados se truncan. Si no se devuelve este parámetro, se han recuperado todos los resultados.	TGlzdFJlc291cm****
RequestId	string	El ID de la solicitud.	11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB
ResourceShareAssociations	array<object>	Una lista de asociaciones.
	array<object>	Detalles de la asociación.
UpdateTime	string	La hora de la última actualización de la asociación. Si `AssociationType` es `Resource`, esta es la hora en que se actualizó el recurso. Si `AssociationType` es `Target`, esta es la hora en que se actualizó el principal.	2020-12-07T07:39:02.920Z
EntityId	string	El ID de la entidad asociada. Si `AssociationType` es `Resource`, este es el ID del recurso. Si `AssociationType` es `Target`, este es el ID del principal.	vsw-bp1upw03qyz8n7us9****
ResourceArn	string	El nombre de recurso de Alibaba Cloud (ARN) del recurso asociado. Nota Se devuelve solo si `AssociationType` es `Resource`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	El nombre del recurso compartido.	example
CreateTime	string	La hora en que se creó la asociación. Si `AssociationType` es `Resource`, esta es la hora en que el recurso se asoció con el recurso compartido. Si `AssociationType` es `Target`, esta es la hora en que el principal se asoció con el recurso compartido.	2020-12-07T07:39:01.818Z
EntityType	string	El tipo de la entidad asociada. Cuando la entidad es un recurso (`AssociationType` es `Resource`), este valor es el tipo de recurso. Para obtener más información, consulte Servicios compatibles con Resource Sharing. Cuando la entidad es un principal (`AssociationType` es `Target`), este valor es `Account`.	VSwitch
ResourceShareId	string	El ID del recurso compartido.	rs-6GRmdD3X****
AssociationStatusMessage	string	El motivo de la asociación fallida.	The reason for the association failure
AssociationType	string	El tipo de asociación. Valores válidos: `Resource`: La entidad es un recurso. `Target`: La entidad es un principal.	Resource
AssociationStatus	string	El estado de la asociación. Valores válidos: Associating: La asociación está en curso. Associated: La asociación se ha completado. Failed: La asociación falló. Disassociating: La desasociación está en curso. Disassociated: La desasociación se ha completado. Nota El sistema elimina automáticamente las asociaciones en estado `Failed` o `Disassociated` dentro de 48 a 96 horas.	Failed
External	boolean	Indica si el principal es una cuenta de Alibaba Cloud que no es miembro de su directorio de recursos. Valores válidos: `true`: El principal es una cuenta externa. `false`: El principal es miembro de su directorio de recursos.	false
AssociationFailedDetails	array<object>	Detalles de una asociación o desasociación fallida.
	object	Detalles de la operación fallida.
Status	string	Este parámetro está obsoleto. Utilice `FailureReason` en su lugar.	无
StatusMessage	string	Este parámetro está obsoleto. Utilice `FailureDescription` en su lugar.	无
AssociateType	string	Este parámetro está obsoleto. Utilice `OperationType` en su lugar.	无
ResourceArn	string	El ARN del recurso asociado. Nota Se devuelve solo si `AssociationType` es `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
EntityType	string	El tipo de la entidad. Si la entidad es un recurso, este valor es el tipo de recurso. Para obtener más información, consulte Servicios compatibles con Resource Sharing. Si la entidad es un principal, este valor puede ser `ResourceDirectory`, `Folder`, `Account` o `Service`.	Account
FailureReason	string	El motivo de la asociación o desasociación fallida. Valores válidos: Unavailable: La operación de uso compartido falló porque el recurso no está disponible. Por ejemplo, es posible que el recurso se haya eliminado. LimitExceeded: El recurso se ha compartido con el número máximo de principales permitido por la cuota. ZonalResourceInaccessible: No se puede acceder al recurso desde la región actual. InternalError: Ocurrió un error interno del servidor. UnsupportedOperation: La operación no es compatible.	Unavailable
FailureDescription	string	Una descripción detallada del fallo de asociación o desasociación.	You cannot access the specified resource at this time
OperationType	string	El tipo de operación que falló. Valores válidos: `Associate` `Disassociate`	Associate
EntityId	string	El ID de la entidad en la asociación fallida. Si la operación implicaba asociar un recurso, este es el ID del principal para el cual falló la asociación. Si la operación implicaba asociar un principal, este es el ID del recurso para el cual falló la asociación.	172050525300****
TargetProperty	string	Las propiedades del principal, como el período de tiempo para compartir recursos. Los valores válidos para `timeRangeType` incluyen: timeRange: un período de tiempo especificado. day: todo el día. Nota Se devuelve solo si el principal es un servicio de Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
ResourceProperty	string	Las propiedades relacionadas con el uso compartido del recurso.	{"sharePrincipals":true,"shareTagOptions":false}

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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 error para ver la lista completa.

Notas de la versión

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