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

Database Autonomy Service:CreateSecurityIPGroup

最終更新日:Mar 13, 2026

複数のプロダクトで共用可能な IP アドレスホワイトリストテンプレートを作成します。

操作説明

同時実行可能数の上限は 10 です。

  • 最新版の Alibaba Cloud SDK または DAS SDK をご使用ください。

  • SDK を使用して DAS サービスを呼び出す場合、リージョンを cn-shanghai に設定してください。

  • オフラインタスクの作成をサポートするのは、DAS Enterprise Edition が有効化されたデータベースインスタンスのみです。各バージョンの DAS Enterprise Edition でサポートされるデータベースおよびリージョンの詳細については、「DAS のエディションとサポートされる機能」をご参照ください。

API 制限:

同時実行可能数の上限は 10 です。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

hdm:CreateSecurityIPGroup

create

*All Resource

*

なし なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionName

string

必須

リージョン ID。

cn-beijing

GlobalIgName

string

必須

IP アドレスホワイトリストテンプレートの名前。以下の要件を満たす必要があります:

  • 小文字の英字、数字、アンダースコア (_) のみを使用できます。

  • 英字で始まり、英字または数字で終わる必要があります。

  • 長さは 2 文字以上 120 文字以下である必要があります。

test_123

GIpList

string

必須

IP アドレスホワイトリストテンプレートに登録する IP アドレス。

説明

複数の IP アドレスをカンマ (,) で区切って指定します。重複した IP アドレスは登録できません。最大 1,000 個の IP アドレスを登録できます。

192.168.0.1

レスポンスフィールド

フィールド

説明

object

Code

string

返された HTTP ステータスコード。

200

Data

object

応答結果のリスト。

GlobalSecurityIPGroup

array<object>

クロスプロダクト向け IP アドレスホワイトリストテンプレートの情報。

object

SecurityIpType

string

IP アドレスのタイプ。

ipv4

RegionId

string

リージョン ID。

例: cn-hangzhou

cn-shenzhen

GlobalIgName

string

IP アドレスホワイトリストテンプレートの名前。以下の要件を満たす必要があります:

  • 小文字の英字、数字、アンダースコア (_) のみを使用できます。

  • 英字で始まり、英字または数字で終わる必要があります。

  • 長さは 2 文字以上 120 文字以下である必要があります。

test

GlobalSecurityGroupId

string

IP アドレスホワイトリストテンプレートの ID。

g-2uztsd6yvhmsqyjXXX

WhitelistNetType

string

ホワイトリストのネットワークタイプ。

mix

GIpList

string

IP アドレスホワイトリストテンプレートに登録する IP アドレス。

説明

複数の IP アドレスをカンマ (,) で区切って指定します。すべての IP アドレスホワイトリストに登録できる IP アドレスおよび CIDR ブロックの合計数は 1,000 個までです。

192.168.0.0/24

Message

string

リクエストに対する応答メッセージ。

説明

リクエストが成功した場合は Successful が返されます。失敗した場合は、エラーコードなどのエラーメッセージが返されます。

Successful

RequestId

string

リクエスト ID。

D578DB3C-06BF-54F2-A78F-C6C25Exxxxxx

Success

string

リクエストが成功したかどうかを示します。有効な値は以下のとおりです:

  • true:リクエストは成功しました。

  • false:リクエストは失敗しました。

true

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Data": {
    "GlobalSecurityIPGroup": [
      {
        "SecurityIpType": "ipv4",
        "RegionId": "cn-shenzhen",
        "GlobalIgName": "test",
        "GlobalSecurityGroupId": "g-2uztsd6yvhmsqyjXXX",
        "WhitelistNetType": "mix",
        "GIpList": "192.168.0.0/24"
      }
    ]
  },
  "Message": "Successful",
  "RequestId": "D578DB3C-06BF-54F2-A78F-C6C25Exxxxxx",
  "Success": "true"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParams The request parameters are invalid.
403 NoPermission You are not authorized to do this action.

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

変更履歴

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