ListResourceShareAssociations - Resource Management

Menanyakan catatan resource atau principal yang terkait dengan sebuah resource share.

Deskripsi operasi

Topik ini memberikan contoh cara menanyakan catatan resource yang terkait dengan resource share yang dibuat oleh akun saat ini di wilayah cn-hangzhou. Respons menunjukkan bahwa akun tersebut telah dikaitkan dengan dua resource berikut:

Pada resource share rs-6GRmdD3X****, resource VSwitch dengan ID vsw-bp1upw03qyz8n7us9**** ditambahkan. Resource tersebut berada dalam status Associated, yang berarti sedang dibagikan.
Pada resource share rs-6GRmdD3X****, resource VSwitch dengan ID vsw-bp183p93qs667muql**** dihapus. Resource tersebut berada dalam status Disassociated, yang berarti tidak lagi dibagikan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

resourcesharing:ListResourceShareAssociations

list

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ResourceId	string	No	ID resource. Catatan Parameter ini tidak tersedia ketika `AssociationType` diatur ke `Target`.	vsw-bp183p93qs667muql****
ResourceArn	string	No	Nama Sumber Daya Alibaba Cloud (ARN) dari resource tersebut. Catatan Parameter ini tidak tersedia ketika `AssociationType` diatur ke `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
Target	string	No	ID principal. Catatan Parameter ini tidak tersedia ketika `AssociationType` diatur ke `Resource`.	172050525300****
AssociationType	string	Yes	Jenis asosiasi. Nilai yang valid: Resource: Menanyakan catatan resource yang terkait. Target: Menanyakan catatan principal yang terkait.	Resource
AssociationStatus	string	No	Status asosiasi. Nilai yang valid: Associating: Entitas sedang dikaitkan. Associated: Entitas telah dikaitkan. Failed: Asosiasi gagal. Disassociating: Entitas sedang diputuskan kaitannya. Disassociated: Entitas telah diputuskan kaitannya. Catatan Sistem menghapus catatan entitas dalam status `Failed` atau `Disassociated` dalam waktu 48 hingga 96 jam.	Associated
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan dalam satu permintaan. Nilai yang valid: 1 hingga 100. Nilai default: 20.	20
NextToken	string	No	Token yang digunakan untuk mengambil halaman hasil berikutnya. Jika respons permintaan saat ini terpotong, Anda dapat menggunakan token ini pada permintaan berikutnya untuk mengambil halaman hasil selanjutnya.	TGlzdFJlc291cm****
ResourceShareIds	array	No	ID resource share. Anda dapat menentukan hingga lima ID resource share.	rs-6GRmdD3X****
	string	No	ID resource share.	rs-6GRmdD3X****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
NextToken	string	Token yang digunakan untuk mengambil halaman hasil berikutnya. Jika respons permintaan saat ini terpotong, Anda dapat menggunakan token ini pada permintaan berikutnya untuk mengambil halaman hasil selanjutnya.	TGlzdFJlc291cm****
RequestId	string	ID permintaan.	11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB
ResourceShareAssociations	array<object>	Informasi mengenai resource atau principal yang terkait.
	array<object>	Informasi mengenai resource atau principal yang terkait.
UpdateTime	string	Waktu saat asosiasi diperbarui. Terdapat skenario berikut: Jika `AssociationType` adalah `Resource`, parameter ini menunjukkan waktu saat resource diperbarui. Jika `AssociationType` adalah `Target`, parameter ini menunjukkan waktu saat principal diperbarui.	2020-12-07T07:39:02.920Z
EntityId	string	ID entitas yang terkait. Nilai yang valid: Jika `AssociationType` adalah `Resource`, parameter ini adalah ID resource. Jika `AssociationType` adalah `Target`, parameter ini adalah ID principal.	vsw-bp1upw03qyz8n7us9****
ResourceArn	string	ARN dari resource yang terkait. Catatan Parameter ini tidak tersedia ketika `AssociationType` adalah `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	Nama resource share.	example
CreateTime	string	Waktu saat asosiasi dibuat. Terdapat skenario berikut: Jika `AssociationType` adalah `Resource`, parameter ini menunjukkan waktu saat resource ditambahkan atau dihapus. Jika `AssociationType` adalah `Target`, parameter ini menunjukkan waktu saat principal ditambahkan atau dihapus.	2020-12-07T07:39:01.818Z
EntityType	string	Jenis entitas yang terkait. Nilai yang valid: Jika entitas adalah resource, parameter ini adalah jenis resource. Untuk informasi lebih lanjut, lihat Services that work with Resource Sharing. Jika entitas adalah principal, parameter ini adalah `Account`.	VSwitch
ResourceShareId	string	ID resource share.	rs-6GRmdD3X****
AssociationStatusMessage	string	Alasan mengapa asosiasi gagal.	The reason for the association failure.
AssociationType	string	Jenis asosiasi. Nilai yang valid: Resource: Entitas adalah resource. Target: Entitas adalah principal.	Resource
AssociationStatus	string	Status asosiasi. Nilai yang valid: Associating: Entitas sedang dikaitkan. Associated: Entitas telah dikaitkan. Failed: Asosiasi gagal. Disassociating: Entitas sedang diputuskan kaitannya. Disassociated: Entitas telah diputuskan kaitannya. Catatan Sistem menghapus catatan entitas dalam status `Failed` atau `Disassociated` dalam waktu 48 hingga 96 jam.	Failed
External	boolean	Menunjukkan apakah principal merupakan akun di luar direktori sumber daya Anda. Nilai yang valid: true: Principal adalah akun di luar direktori sumber daya Anda. false: Principal adalah anggota direktori sumber daya Anda.	false
AssociationFailedDetails	array<object>	Rincian kegagalan asosiasi atau disasosiasi.
	object	Rincian kegagalan asosiasi atau disasosiasi.
Status	string	Parameter ini sudah tidak digunakan lagi. Gunakan FailureReason sebagai gantinya.	无
StatusMessage	string	Parameter ini sudah tidak digunakan lagi. Gunakan FailureDescription sebagai gantinya.	无
AssociateType	string	Parameter ini sudah tidak digunakan lagi. Gunakan OperationType sebagai gantinya.	无
ResourceArn	string	ARN dari resource yang terkait. Catatan Parameter ini tidak tersedia ketika `AssociationType` adalah `Resource`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
EntityType	string	Jenis entitas yang terkait. Nilai yang valid: Jika entitas adalah resource, parameter ini adalah jenis resource. Untuk informasi lebih lanjut, lihat Services that work with Resource Sharing. Jika entitas adalah principal, parameter ini dapat berupa `ResourceDirectory`, `Folder`, `Account`, atau `Service`.	Account
FailureReason	string	Alasan mengapa asosiasi atau disasosiasi gagal. Nilai yang valid: Unavailable: Resource tidak ada atau berada dalam status tidak valid. LimitExceeded: Jumlah principal yang dapat berbagi resource melebihi batas atas. ZonalResourceInaccessible: Resource tidak tersedia di wilayah tersebut. InternalError: Terjadi kesalahan internal. UnsupportedOperation: Operasi tidak didukung.	Unavailable
FailureDescription	string	Deskripsi rinci mengenai kegagalan tersebut.	You cannot access the specified resource at this time.
OperationType	string	Jenis operasi. Nilai yang valid: Associate: Mengaitkan entitas. Disassociate: Memutuskan kaitan entitas.	Associate
EntityId	string	ID entitas yang terkait. Nilai yang valid: Jika AssociationType adalah Resource, parameter ini adalah ID principal. Jika AssociationType adalah Target, parameter ini adalah ID resource.	172050525300****
TargetProperty	string	Properti principal. Misalnya, rentang waktu resource dibagikan. Nilai yang valid untuk `timeRangeType`: timeRange: periode waktu tertentu. day: sepanjang hari. Catatan Parameter ini hanya dikembalikan ketika principal adalah layanan Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
ResourceProperty	string		{"sharePrincipals":true,"shareTagOptions":false}

Contoh

Respons sukses

JSONformat

{
  "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}"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	MissingParameter.AssociationType	You must specify AssociationType.
400	InvalidParameter.AssociationType	The AssociationType is invalid.
400	InvalidParameter.AssociationStatus	The AssociationStatus is invalid.
400	InvalidParameter.MaxResults	The MaxResults is invalid.
400	InvalidParameter.NextToken	The NextToken is invalid.
400	InvalidParameter.NextToken.Length	The maximum length of NextToken exceeds 256 characters.
400	InvalidParameter.ResourceShareIds	The ResourceShareIds is invalid.
400	InvalidParameter.ResourceShareIds.Duplicate	The ResourceShareIds contains duplicate values.
400	InvalidParameter.ResourceShareIds.Length	The maximum length of ResourceShareIds exceeds 5 characters.
400	InvalidParameter.Target	The Target is invalid.
400	InvalidParameter.ResourceId	The ResourceId is invalid.
400	ConflictedAssociationType	The specified ResourceId or Target conflicts with AssociationType.
400	InvalidParameter	The specified parameter is invalid.
400	InvalidParameter.ResourceArn	The ResourceArn is invalid.
400	InvalidParameter.ResourceConflict	Both ResourceId and ResourceArn cannot be specified simultaneously. Please provide only one of these parameters.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.