すべてのプロダクト
Search
ドキュメントセンター

Cloud Config:PutDeliveryChannel

最終更新日:Jul 28, 2025

アカウントの配信チャネルを作成または更新します。

説明

この API は廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。代わりに Config(2020-09-07) - CreateConfigDeliveryChannel への移行を推奨します。より強化された機能に加え、サポートも引き続きご利用いただけます。

操作説明


今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

config:PutDeliveryChannel

update

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

タイプ

必須 / 任意

説明

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。トークンはクライアントで生成できますが、異なるリクエスト間で一意である必要があります。 `ClientToken` の値には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

1594295238-f9361358-5843-4294-8d30-b5183fac****

DeliveryChannelId

string

任意

配信チャネルの ID 。配信チャネルを更新する場合は、このパラメーターが必要です。

cdc-193f6457e0d90080****

DeliveryChannelName

string

任意

配信チャネルの名前。

testoss

DeliveryChannelType

string

必須

配信チャネルのタイプ。配信チャネルを作成する場合は、このパラメーターが必要です。有効な値:

  • OSS:Object Storage Service

  • MNS:Simple Message Queue (旧称:MNS)

  • SLS:Simple Log Service

OSS

DeliveryChannelTargetArn

string

必須

配信先の ARN 。配信チャネルを作成する場合は、このパラメーターが必要です。有効な値:

  • 配信チャネルタイプが OSS の場合、値は acs:oss:{RegionId}:{Aliuid}:{bucketName} の形式です。

  • 配信チャネルタイプが MNS の場合、値は acs:mns:{RegionId}:{Aliuid}:/topics/{topicName} の形式です。

  • 配信チャネルタイプが SLS の場合、値は acs:log:{RegionId}:{Aliuid}:project/{projectName}/logstore/{logstoreName} の形式です。

acs:oss:cn-hangzhou:100931896542****:20171130--1

DeliveryChannelAssumeRoleArn

string

必須

データ配信のために偽装するロールの ARN 。配信チャネルを作成する場合は、このパラメーターが必要です。

説明

Cloud Config のサービスリンクロールを使用する場合は、例の値を使用し、アカウント ID を Alibaba Cloud アカウントの ID に置き換えることができます。

acs:ram::100931896542****:role/aliyunserviceroleforconfig

DeliveryChannelCondition

string

任意

配信チャネルにアタッチされるルール。このパラメーターは、MNS タイプの配信チャネルでのみ使用できます。

サブスクライブするイベントの最低リスクレベルとリソースタイプを指定できます。詳細は以下のとおりです。

  • サブスクライブするイベントの最低リスクレベルは、{"filterType":"RuleRiskLevel","value":"1","multiple":false} の形式で指定されます。

    `value` はフィルタリングするリスクレベルを示します。有効な値: 1 は高リスク、 2 は中リスク、 3 は低リスクを示します。

  • サブスクライブするイベントのリソースタイプは、{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true} の形式で指定されます。

    `values` は、サブスクライブするイベントのリソースタイプを示します。値は JSON 配列です。 例えば: [{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]

[{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]

Description

string

任意

配信チャネルの説明。

My OSS delivery.

Status

integer

任意

配信チャネルのステータス。有効な値:

  • 0:配信チャネルは無効になっています。

  • 1(デフォルト):配信チャネルは有効になっています。

1

レスポンスパラメーター

パラメーター

タイプ

説明

object

DeliveryChannelId

string

配信チャネルの作成または更新後に返される配信チャネルの ID 。

cdc-ee0f626622af0069****

RequestId

string

リクエストの ID 。

0D6B9E0A-AD53-4732-922B-0F584ECA5FAB

成功レスポンス

JSONJSON

{
  "DeliveryChannelId": "cdc-ee0f626622af0069****",
  "RequestId": "0D6B9E0A-AD53-4732-922B-0F584ECA5FAB"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 DeliveryChannelNotExists The delivery channel does not exist.
400 Invalid.DeliveryChannelName.Empty You must specify DeliveryChannelName.
400 Invalid.DeliveryChannelType.Empty You must specify DeliveryChannelType.
400 Invalid.DeliveryChannelAssumeRoleArn.Empty You must specify DeliveryChannelAssumeRoleArn.
400 Invalid.DeliveryChannelAssumeRoleArn.Format The specified format of DeliveryChannelAssumeRoleArn is invalid.
400 Invalid.DeliveryChannelTargetArn.Empty You must specify DeliveryChannelTargetArn.
400 Invalid.DeliveryChannelTargetArn.Format The specified format of DeliveryChannelTargetArn is invalid.
400 Invalid.DeliveryChannelCondition.Format The specified format of DeliveryChannelCondition is invalid.
400 MemberNotBelongToMaster The specified member does not belong to your organization.
400 DeliveryChannelAccountNotSupport Cross-account delivery that is not in the RD is not supported.
400 DeliveryChannelMnsUnreachable The MNS topic is unreachable.
400 DeliveryChannelOssUnreachable The OSS bucket is unreachable.
400 DeliveryChannelSlsUnreachable SLS logstore is unreachable.
404 AccountNotExisted Your account does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。