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

Simple Log Service:GetCollectionPolicy

最終更新日:Sep 18, 2026

指定された収集ポリシーを取得します。

操作説明

この操作は、中国 (上海)、シンガポール、および cn-heyuan-acdr-1 (河源中国自動車コンプライアンスクラウド) の各エンドポイントでのみ使用できます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

log:GetCollectionPolicy

get

*CollectionPolicy。

acs:log::{#accountId}:collectionpolicy/{#policyName}

  • log:TLSVersion
なし

リクエスト構文

GET /collectionpolicy/{policyName} HTTP/1.1

パスパラメーター

パラメーター

型

必須 / 任意

説明

例

policyName

string

必須

ポリシー名。

your_ログ_ポリシー

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

productCode

string

任意

プロダクトコード。

oss

dataCode

string

任意

ログタイプコード。

access_log

レスポンスフィールド

フィールド

型

説明

例

object

レスポンス構造体。

collectionPolicy

object

収集ポリシー。

centralizeConfig

object

集中送信構成。

destLogstore

string

集中送信の送信先 Logstore。

your-sls-logstore-in-beijing

destProject

string

集中送信の送信先プロジェクト。

your-sls-プロジェクト-in-beijing

destRegion

string

集中送信のターゲットリージョン。

cn-beijing

destTTL

integer

集中送信のデータ保持期間 (日数)。

0

centralizeEnabled

boolean

集中ストレージが有効かどうかを示します。

false

dataCode

string

ログタイプコード。

access_log

dataConfig

object

ログタイプがグローバルログタイプ (プロダクトコード が sls に設定されている場合など) の場合にのみサポートされる構成。それ以外の場合、このパラメーターは空です。

dataProject

string

このパラメーターは、ログタイプがグローバルログタイプ (プロダクトコード が sls に設定されている場合など) の場合にのみ有効です。このパラメーターが空の場合、ログは指定された dataRegion 内のアカウントのデフォルトの専用プロジェクトに収集されます。

""

dataRegion

string

ログタイプがグローバルログタイプ (プロダクトコード が sls に設定されている場合など) の場合にのみサポートされる構成。このパラメーターは、初期構成時にグローバルログが収集されるリージョンを指定します。

cn-beijing

enabled

boolean

ポリシーが有効かどうかを示します。

true

internalPolicy

boolean

ポリシーが組み込みポリシーかどうかを示します。組み込みポリシーは変更または削除できません。

false

policyConfig

object

収集ポリシー構成。

instanceIds

array

インスタンス ID のリスト。

string

インスタンス ID。

your-test-bucket1

regions

array

インスタンスが属するリージョンのリスト。ワイルドカードを使用できます。

string

リージョン ID。

cn-hangzhou

resourceMode

string

リソース収集モード。

all

resourceTags

object

リソースタグ。

{"tag1":"value1","tag2":"value2"}

policyName

string

ポリシー名。

your_ログ_ポリシー

policyUid

string

ポリシーが属するアカウントの Alibaba Cloud アカウント ID。ポリシーがリソースディレクトリ管理者またはリソースディレクトリ委任管理者によって作成された場合、このパラメーターはその管理者の Alibaba Cloud アカウント ID に設定されます。

148***********50

productCode

string

プロダクトコード。

oss

resourceDirectory

object

リソースディレクトリ構成。リソースディレクトリが構成されていない場合、このパラメーターは空です。

accountGroupType

string

リソースディレクトリ内のアカウントグループタイプ。有効な値:

  • all: すべてのアカウント。

  • custom: カスタムアカウント。

all,custom

members

array

リソースディレクトリ構成がカスタムモードに設定されている場合のメンバーアカウントのリスト。

string

Alibaba Cloud アカウント ID。

165***********50

例

成功レスポンス

JSONJSON

{
  "collectionPolicy": {
    "centralizeConfig": {
      "destLogstore": "your-sls-logstore-in-beijing\n",
      "destProject": "your-sls-project-in-beijing\n",
      "destRegion": "cn-beijing\n",
      "destTTL": 0
    },
    "centralizeEnabled": false,
    "dataCode": "access_log",
    "dataConfig": {
      "dataProject": "\"\"",
      "dataRegion": "cn-beijing"
    },
    "enabled": true,
    "internalPolicy": false,
    "policyConfig": {
      "instanceIds": [
        "your-test-bucket1\n"
      ],
      "regions": [
        "cn-hangzhou"
      ],
      "resourceMode": "all",
      "resourceTags": {
        "tag1": "value1",
        "tag2": "value2"
      }
    },
    "policyName": "your_log_policy",
    "policyUid": "148***********50\n",
    "productCode": "oss",
    "resourceDirectory": {
      "accountGroupType": "all,custom",
      "members": [
        "165***********50"
      ]
    }
  }
}

エラーコード

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

変更履歴

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