Otomatisasi pengiriman resource menggunakan CreateDeliveryChannel API-Resource Management-Alibaba Cloud - Resource Management

Membuat saluran pengiriman Sumber daya untuk akun saat ini.

Deskripsi operasi

Resource delivery supports the scheduled delivery of resource snapshots and the delivery of resource configuration changes.

Scheduled delivery of resource snapshots supports two scenarios:

Standard delivery: Leave the ResourceSnapshotDelivery.CustomExpression parameter empty.
Custom delivery: Set the ResourceSnapshotDelivery.CustomExpression parameter to an appropriate value.

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

resourcecenter:CreateDeliveryChannel

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DeliveryChannelName	string	Yes	Nama saluran pengiriman.	test-delivery
DeliveryChannelDescription	string	No	Deskripsi saluran pengiriman.	测试投递
ResourceSnapshotDelivery	object	No	Pengiriman terjadwal snapshot Sumber daya.
DeliveryTime	string	No	The delivery time.	09:00Z
TargetArn	string	No	The Alibaba Cloud Resource Name (ARN) of the destination. Valid values: If you set `TargetType` to `OSS`, set `TargetArn` to the ARN of an Object Storage Service (OSS) bucket that has the `resourcecenter-` prefix. Example: `acs:oss:cn-hangzhou:191142248777**:resourcecenter-oss`. If you set `TargetType` to `SLS`, set `TargetArn` to the ARN of a Simple Log Service (SLS) Logstore that has the `resourcecenter-` prefix. Example: `acs:log:cn-hangzhou: 191142248777**:project/delivery/logstore/resourcecenter-sls`.	acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
TargetType	string	No	The type of the destination. Valid values: For standard scheduled delivery, set this parameter to `OSS`. For custom scheduled delivery, set this parameter to `OSS` or `SLS`. Valid values: SLS : SLS OSS : OSS	OSS
CustomExpression	string	No	The custom expression.	select * from resources limit 100;
SlsProperties	object	No	The SLS configurations.
OversizedDataOssTargetArn	string	No	The ARN of the destination OSS bucket for oversized files. If the size of a resource configuration change event exceeds 1 MB, the event is delivered as an OSS object. Set this parameter to the ARN of an OSS bucket that has the `resourcecenter-` prefix. Catatan This parameter is valid only for custom scheduled delivery. You do not need to specify this parameter for standard scheduled delivery.	acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
ResourceChangeDelivery	object	No	Pengiriman perubahan konfigurasi Sumber daya.
SlsProperties	object	No	The SLS configurations.
OversizedDataOssTargetArn	string	No	The ARN of the destination OSS bucket for oversized files. If the size of a resource configuration change event exceeds 1 MB, the event is delivered as an OSS object. Set this parameter to the ARN of an OSS bucket that has the `resourcecenter-` prefix.	acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
TargetArn	string	No	The ARN of the destination. Valid values: If you set `TargetType` to `OSS`, set `TargetArn` to the ARN of an OSS bucket that has the `resourcecenter-` prefix. If you set `TargetType` to `SLS`, set `TargetArn` to the ARN of an SLS Logstore that has the `resourcecenter-` prefix.	acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
TargetType	string	No	The type of the destination. Valid value: `SLS`. Valid values: SLS : SLS	SLS
DeliveryChannelFilter	object	Yes	Cakupan efektif saluran pengiriman.
ResourceTypes	array	No	The list of resource types to be delivered.
	string	No	The resource type to be delivered. For more information, see Services that work with Resource Center. To deliver all resource types supported by Resource Center, enter `ALL`.	ACS::VPC::VPC

Elemen respons

Element	Type	Description	Example
	object	The response parameters.
DeliveryChannelId	string	The ID of the delivery channel.	dc-0bzhsqpn****
RequestId	string	The request ID.	42A89312-0616-591E-B614-07BC87D3D

Contoh

Respons sukses

JSONformat

{
  "DeliveryChannelId": "dc-0bzhsqpn****",
  "RequestId": "42A89312-0616-591E-B614-07BC87D3D"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	NoPermission.ServiceLinkedRole	The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize custom policy: Service Name: rmc.resourcemanager.aliyuncs.com, Action: ram:CreateServiceLinkedRole.
400	InvalidParameter.ResourceChangeDelivery.TargetArn	The specified parameter ResourceChangeDelivery.TargetArn is not valid.
403	ExceedLimit.DeliveryChannelQuota	The number of delivery channels exceeds the limit.
403	NoPermission.ResourceType	The operator is not permitted for this resource type.
404	MissingParameter.DeliveryName	The specified parameter DeliveryName is missing.
404	MissingParameter.OverSizedDataOssTargetArn	The specified parameter OverSizedDataOssTargetArn is missing.
404	MissingParameter.DeliveryFilter	The specified parameter DeliveryFilter is missing.
404	MissingParameter.DeliveryFilter.AccountScopes	The specified parameter DeliveryFilter.AccountScopes is missing.
404	MissingParameter.ResourceSnapshotDelivery.TargetType	The specified parameter ResourceSnapshotDelivery.TargetType is missing.
404	MissingParameter.ResourceChangeDelivery.TargetArn	The specified parameter ResourceChangeDelivery.TargetArn is missing.
404	MissingParameter.ResourceChangeDelivery.TargetType	The specified parameter ResourceChangeDelivery.TargetType is missing.
404	MissingParameter.ResourceSnapshotDelivery.TargetArn	The specified parameter ResourceSnapshotDelivery.TargetArn is missing.
404	MissingParameter.ResourceDeliveryConfiguration	The parameter ResourceSnapshotDelivery or ResourceChangeDelivery must be specified.
404	MissingParameter.ResourceSnapshotDelivery.CustomExpression	The specified parameter ResourceSnapshotDelivery.CustomExpression is missing.
404	MissingParameter.ResourceSnapshotDelivery.DeliveryTime	The specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.
404	MissingParameter.DeliveryConfiguration	The parameter ConfigurationSnapshotDelivery or ConfigurationChangeDelivery must be specified.
409	AlreadyExists.DeliveryName	The DeliveryName Name already exists.
409	InvalidParameter.DeliveryName	The specified parameter DeliveryName is not valid.
409	InvalidParameter.DeliveryDescription	The specified parameter DeliveryDescription is not valid.
409	InvalidParameter.OverSizedDataOssTargetArn	The specified parameter OverSizedDataOssTargetArn is not valid.
409	InvalidParameter.DeliveryFilter.AccountScopes	The specified parameter DeliveryFilter.AccountScopes is not valid.
409	InvalidParameter.DeliveryFilter.ResourceTypes	The specified parameter DeliveryFilter.ResourceTypes is not valid.
409	InvalidParameter.ConfigurationSnapshotDelivery.TargetType	The specified parameter ConfigurationSnapshotDelivery.TargetType is not valid.
409	InvalidParameter.ResourceSnapshotDelivery.TargetArn	The specified parameter ResourceSnapshotDelivery.TargetArn is not valid.
409	InvalidParameter.ResourceSnapshotDelivery.DeliveryTime	The specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid.
409	InvalidParameter.ResourceSnapshotDelivery.TargetType	The specified parameter ResourceSnapshotDelivery.TargetType is not valid.
409	InvalidParameter.ResourceChangeDelivery.TargetType	The specified parameter ResourceChangeDelivery.TargetType is not valid.
409	InvalidParameter.CustomExpression	Error: %s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.