ListResourceShareAssociations - Resource Management

Menampilkan daftar resource atau principal yang terkait dengan sebuah resource share.

Deskripsi operasi

Contoh berikut menunjukkan cara melakukan kueri terhadap catatan asosiasi Shared Resources dalam Resource Shares yang dibuat oleh akun saat ini di wilayah China (Hangzhou). Respons menampilkan catatan untuk dua Shared Resources berikut:

Shared Resource VSwitch, vsw-bp1upw03qyz8n7us9****, dikaitkan dengan Resource Share rs-6GRmdD3X****. Resource tersebut berada dalam status Associated, artinya sedang aktif dibagikan.
Shared Resource VSwitch, vsw-bp183p93qs667muql****, diputuskan kaitannya dari Resource Share rs-6GRmdD3X****. Resource tersebut berada dalam status Disassociated, artinya 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	Alibaba Cloud Resource Name (ARN) dari resource. 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`: Mengembalikan asosiasi dengan shared resources. `Target`: Mengembalikan asosiasi dengan principals.	Resource
AssociationStatus	string	No	Status asosiasi. Nilai yang valid: `Associating`: Asosiasi sedang berlangsung. `Associated`: Asosiasi telah berhasil. `Failed`: Asosiasi gagal. `Disassociating`: Pemutusan asosiasi sedang berlangsung. `Disassociated`: Asosiasi telah dihapus. Catatan Sistem secara otomatis menghapus catatan dengan status `Failed` atau `Disassociated` dalam waktu 48 hingga 96 jam.	Associated
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan per halaman. Nilai yang valid: 1 hingga 100. Nilai default: 20.	20
NextToken	string	No	Token untuk halaman hasil berikutnya. Jika respons sebelumnya terpotong, sertakan `token` ini untuk mengambil sisa hasil.	TGlzdFJlc291cm****
ResourceShareIds	array	No	ID resource shares. Anda dapat menentukan hingga 5 ID resource share.	rs-6GRmdD3X****
	string	No	ID resource share.	rs-6GRmdD3X****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
NextToken	string	Token untuk mengambil halaman hasil berikutnya. `NextToken` hanya dikembalikan jika hasil terpotong. Jika parameter ini tidak dikembalikan, berarti semua hasil telah diambil.	TGlzdFJlc291cm****
RequestId	string	ID permintaan.	11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB
ResourceShareAssociations	array<object>	Daftar asosiasi.
	array<object>	Detail asosiasi.
UpdateTime	string	Waktu terakhir asosiasi diperbarui. Jika `AssociationType` adalah `Resource`, ini adalah waktu resource diperbarui. Jika `AssociationType` adalah `Target`, ini adalah waktu principal diperbarui.	2020-12-07T07:39:02.920Z
EntityId	string	ID entitas yang terkait. Jika `AssociationType` adalah `Resource`, ini adalah ID resource. Jika `AssociationType` adalah `Target`, ini adalah ID principal.	vsw-bp1upw03qyz8n7us9****
ResourceArn	string	Alibaba Cloud Resource Name (ARN) dari resource yang terkait. Catatan Hanya dikembalikan jika `AssociationType` adalah `Resource`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	Nama resource share.	example
CreateTime	string	Waktu asosiasi dibuat. Jika `AssociationType` adalah `Resource`, ini adalah waktu resource dikaitkan dengan resource share. Jika `AssociationType` adalah `Target`, ini adalah waktu principal dikaitkan dengan resource share.	2020-12-07T07:39:01.818Z
EntityType	string	Jenis entitas yang terkait. Ketika entitas adalah resource (`AssociationType` adalah `Resource`), nilai ini adalah jenis resource. Untuk informasi lebih lanjut, lihat Services that work with Resource Sharing. Ketika entitas adalah principal (`AssociationType` adalah `Target`), nilai ini adalah `Account`.	VSwitch
ResourceShareId	string	ID resource share.	rs-6GRmdD3X****
AssociationStatusMessage	string	Alasan kegagalan asosiasi.	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: Asosiasi sedang berlangsung. Associated: Asosiasi telah selesai. Failed: Asosiasi gagal. Disassociating: Pemutusan asosiasi sedang berlangsung. Disassociated: Pemutusan asosiasi telah selesai. Catatan Sistem secara otomatis menghapus asosiasi dengan status `Failed` atau `Disassociated` dalam waktu 48 hingga 96 jam.	Failed
External	boolean	Menunjukkan apakah principal adalah Akun Alibaba Cloud yang bukan anggota Resource Directory Anda. Nilai yang valid: `true`: Principal adalah Akun eksternal. `false`: Principal adalah anggota Resource Directory Anda.	false
AssociationFailedDetails	array<object>	Detail kegagalan asosiasi atau disasosiasi.
	object	Detail operasi yang gagal.
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 Hanya dikembalikan jika `AssociationType` adalah `Target`.	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
EntityType	string	Jenis entitas. Jika entitas adalah resource, nilai ini adalah jenis resource. Untuk informasi lebih lanjut, lihat Services that work with Resource Sharing. Jika entitas adalah principal, nilai ini dapat berupa `ResourceDirectory`, `Folder`, `Account`, atau `Service`.	Account
FailureReason	string	Alasan kegagalan asosiasi atau disasosiasi. Nilai yang valid: Unavailable: Operasi berbagi gagal karena resource tidak tersedia. Misalnya, resource mungkin telah dihapus. LimitExceeded: Resource telah dibagikan ke jumlah maksimum principal yang diizinkan oleh Quota. ZonalResourceInaccessible: Resource tidak dapat diakses dari Region saat ini. InternalError: Terjadi kesalahan internal pada server. UnsupportedOperation: Operasi ini tidak didukung.	Unavailable
FailureDescription	string	Deskripsi detail kegagalan asosiasi atau disasosiasi.	You cannot access the specified resource at this time.
OperationType	string	Jenis operasi yang gagal. Nilai yang valid: `Associate` `Disassociate`	Associate
EntityId	string	ID entitas dalam asosiasi yang gagal. Jika operasi melibatkan pengaitan resource, ini adalah ID principal yang gagal dikaitkan. Jika operasi melibatkan pengaitan principal, ini adalah ID resource yang gagal dikaitkan.	172050525300****
TargetProperty	string	Properti principal, seperti periode berbagi resource. Nilai yang valid untuk `timeRangeType` meliputi: timeRange: periode waktu tertentu. day: sepanjang hari. Catatan Hanya dikembalikan jika principal adalah layanan Alibaba Cloud.	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
ResourceProperty	string	Properti resource yang terkait dengan berbagi.	{"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.