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

Container Service for Kubernetes:DescribeAutoRepairPolicy

最終更新日:Apr 04, 2026

自動修復ルールを照会します。

操作説明

重要 この API はまだ利用できません。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cs:DescribeAutoRepairPolicy

none

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

なし なし

リクエスト構文

GET /clusters/{cluster_id}/auto_repair_policies/{policy_id} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

cluster_id

string

任意

クラスター ID。

c82e6987e2961451182edacd74faf****

policy_id

string

任意

自動修復ポリシー ID。

r-xxxxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

説明

object

応答データ。

name

string

自動修復ポリシーの名前。

test

id

string

自動修復ポリシーの ID。

r-xxx

resource_type

string

自動修復ポリシーがバインドされているリソースのタイプ。

nodepool

resource_ids

array

自動修復ポリシーがバインドされているリソース ID のリスト。

string

リソース ID。

npxxxxx

rules

array<object>

自動修復サブルールのリスト。

array<object>

自動修復サブルール。

incidents

array<object>

修復プロシージャをトリガーするインシデントのリスト。

object

インシデント。

name

string

インシデントの名前。

Node.FaultNeedReboot.HOST

type

string

インシデントのタイプ。

system

repair_procedure

array<object>

修復ステップのシーケンス。

array<object>

修復プロシージャのステップ。

name

string

修復ステップの名前。

QuarantineGPU

intervention

object

手動介入の設定。

enable

boolean

手動承認が有効になっているかどうか。

true

type

string

手動承認のタイプ。

label

inquiring_label

object

問い合わせラベルの設定。この修復ステップが開始されると、Container Service for Kubernetes (ACK) はこのラベルをノードに追加し、処理を続行するための承認を待ちます。

key

string

ラベルキー。

k8s.aliyun.com/incident

value

string

ラベル値。

inquiring

approved_label

object

承認済みラベルの設定。このラベルをノードに追加することで、ACK に修復ステップの実行を承認します。ステップが完了すると、ACK は問い合わせラベルと承認済みラベルの両方を削除します。このラベルを速やかに追加しない場合、修復プロセスは一時停止し、ノードは障害状態のままになります。

key

string

承認ラベルの key

k8s.aliyun.com/incident

value

string

承認ラベルの値。

approved

config

object

修復ステップの設定パラメーター。

any

設定パラメーターのキーと値のペア。

"drain_timeout": "30s"

resource_sub_type

string

自動修復ポリシーが適用されるリソースのサブタイプ。

ess

成功レスポンス

JSONJSON

{
  "name": "test",
  "id": "r-xxx",
  "resource_type": "nodepool",
  "resource_ids": [
    "npxxxxx"
  ],
  "rules": [
    {
      "incidents": [
        {
          "name": "Node.FaultNeedReboot.HOST",
          "type": "system"
        }
      ],
      "repair_procedure": [
        {
          "name": "QuarantineGPU",
          "intervention": {
            "enable": true,
            "type": "label",
            "inquiring_label": {
              "key": "k8s.aliyun.com/incident",
              "value": "inquiring"
            },
            "approved_label": {
              "key": "k8s.aliyun.com/incident",
              "value": "approved"
            }
          },
          "config": {
            "key": "\"drain_timeout\": \"30s\" "
          }
        }
      ]
    }
  ],
  "resource_sub_type": "ess"
}

エラーコード

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

変更履歴

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