OpsItem 更新の自動化 via API および RAM 認可 - OOS - Alibaba Cloud - CloudOps Orchestration Service

OpsItem を変更します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

oos:UpdateOpsItem

update

*運用項目。

acs:oos:{#regionId}:{#accountId}:opsitem/{#OpsItemId}

oos:TLSVersion

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-hangzhou
Title	string	任意	OpsItem のタイトル。	Test
Description	string	任意	OpsItem の説明。	test-update
ResourceGroupId	string	任意	リソースグループ ID。	rg-acfmxsn4m4******
Tags	object	任意	タグ。	{ "k1": "v1", "k2": "v2" }
ClientToken	string	任意	べき等性トークン。	DASKJJLKADS-AHKLJHJSAKL-AJK
Severity	string	任意	重大度レベル。列挙値: High : High。 Low : Low。 Medium : Medium。 Critical : Critical。	Medium
Source	string	任意	ソースサービス。	/aliyun/ecs
Category	string	任意	カテゴリ。列挙値: Availability : Availability。 Performance : Performance。 Security : Security。 Cost : Cost。 Recovery : バックアップとリカバリ。	Security
Priority	integer	任意	優先度。列挙値: 1 : 1 2 : 2 3 : 3 4 : 4 5 : 5	2
Solutions	string	任意	ソリューションのリスト。	[{\n \"優先度\":3,\n \"type\":\"url\",\n \"url\":\"https://example.com\",\n \"description\":\"クラスターにクロスゾーンの高可用性を設定します。\"\n}]
DedupString	string	任意	重複排除文字列。	ecs_instance_SystemMaintenance.Reboot
Resources	string	任意	関連付けられたリソースの Amazon リソースネーム (ARN) のリスト。	[\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\"]
OpsItemId	string	任意	OpsItem の ID。OpsItemId と Resources のうち、少なくとも 1 つのソースを指定する必要があります。	oi-e2264dcf040c472598e9
Status	string	任意	ステータス。列挙値: InProgress : 進行中。 Resolved : 解決済み。 Open : オープン。	Open
AssigneeId	string	任意	担当者の識別子 (type:id フォーマット)。	user:123456789
PlannedFinishTime	string	任意	予定終了時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2026-09-01T00:00:00Z
ActualFinishTime	string	任意	実際の終了時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2026-08-30T18:00:00Z
StatusChangeReason	string	任意	ステータス変更の理由。Status が Rejected に設定されている場合、このパラメーターは必須です。	受け入れ基準を満たしておらず、再処理が必要です
Progress	integer	任意	進捗率。有効な値: 0～100。	50
EstimatedEffortHours	number	任意	推定作業時間。	8.0
ActualEffortHours	number	任意	実際の作業時間。	6.5

レスポンスフィールド

フィールド	型	説明	例
	object
OpsItem	object	OpsItem。
ActualEffortHours	number	実際の作業時間。	6.5
ActualFinishTime	string	実際の終了時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2026-08-30T18:00:00Z
AssigneeId	string	担当者の識別子 (type:id フォーマット)。	user:123456789
Attributes	string	OpsItem の属性情報。	[{'Attribute': {'Weight': 100}, 'RealServer': 'uaejc8hnqzqz5valyh8dibolpvza48ik.yundunwaf5.com'}]
Category	string	カテゴリ。	Security
CreateDate	string	作成時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2023-03-16T07:04Z
CreatedBy	string	OpsItem の作成者。	root(130900000)
Description	string	説明。	test-update
EstimatedEffortHours	number	推定作業時間。	8.0
LastModifiedBy	string	OpsItem の最終修飾子。	root(130900000)
OpsItemId	string	OpsItem の ID。	oi-e2264dcf040c472598e9
PlannedFinishTime	string	予定終了時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2026-09-01T00:00:00Z
Priority	integer	優先度。	2
Progress	integer	進捗率。有効な値: 0～100。	50
ResourceGroupId	string	リソースグループ ID。	rg-acfmxsn4m4******
Resources	array	関連付けられたリソースの Amazon リソースネーム (ARN) のリスト。
	string	関連付けられたリソースの Amazon リソースネーム (ARN)。	[\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\"]
Severity	string	重大度レベル。	Medium
Solutions	array	ソリューションのリスト。	[{"優先度":2,"type":"SlbNeedEcs","url":"https://computenest.console.alibabacloud.com/app","description":"SLB 配下のすべての ECS インスタンスをアプリケーショングループにインポートします"}]
	string	ソリューション。	[{\n \"優先度\":2,\n \"type\":\"SlbNeedEcs\",\n \"url\":\"https://computenest.console.alibabacloud.com/app\",\n \"description\":\"SLB インスタンス配下のすべての ECS インスタンスをアプリケーショングループにインポートします。\"\n}]
Source	string	ソースサービス。	/aliyun/ecs
Status	string	ステータス。	Open
Tags	object	タグ。	{ "k1": "v1", "k2": "v2" }
Title	string	OpsItem のタイトル。	Test
UpdateDate	string	更新時間 (ISO 8601 フォーマット、協定世界時 (UTC))。	2023-03-16T08:04Z
RequestId	string	リクエスト ID。	C996DECB-3D2B-5321-B359-BE7031B6399E

例

成功レスポンス

JSONJSON

{
  "OpsItem": {
    "ActualEffortHours": 6.5,
    "ActualFinishTime": "2026-08-30T18:00:00Z",
    "AssigneeId": "user:123456789",
    "Attributes": "[{'Attribute': {'Weight': 100}, 'RealServer': 'uaejc8hnqzqz5valyh8dibolpvza48ik.yundunwaf5.com'}]",
    "Category": "Security",
    "CreateDate": "2023-03-16T07:04Z",
    "CreatedBy": "root(130900000)",
    "Description": "test-update",
    "EstimatedEffortHours": 8,
    "LastModifiedBy": "root(130900000)",
    "OpsItemId": "oi-e2264dcf040c472598e9",
    "PlannedFinishTime": "2026-09-01T00:00:00Z",
    "Priority": 2,
    "Progress": 50,
    "ResourceGroupId": "rg-acfmxsn4m4******",
    "Resources": [
      "[\\\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\\\"]"
    ],
    "Severity": "Medium",
    "Solutions": [
      "[{\\n    \\\"優先度\\\":2,\\n    \\\"type\\\":\\\"SlbNeedEcs\\\",\\n    \\\"url\\\":\\\"https://computenest.console.alibabacloud.com/app\\\",\\n    \\\"description\\\":\\\"SLB インスタンス配下のすべての ECS インスタンスをアプリケーショングループにインポートします\\\"\\n}]"
    ],
    "Source": "/aliyun/ecs",
    "Status": "Open",
    "Tags": {
      "k1": "v1",
      "k2": "v2"
    },
    "Title": "Test",
    "UpdateDate": "2023-03-16T08:04Z"
  },
  "RequestId": "C996DECB-3D2B-5321-B359-BE7031B6399E"
}

エラーコード

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

変更履歴

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