すべてのプロダクト
Search

このプロダクト

    Elastic IP Address:CreatePublicIpAddressPool

    ドキュメントセンター

    Elastic IP Address:CreatePublicIpAddressPool

    最終更新日:Jul 07, 2026

    CreatePublicIpAddressPool 操作を呼び出して、IP アドレスプールを作成します。

    操作説明

    IP アドレスプール機能はデフォルトでは利用できません。この機能を使用するには、クォータセンターで IP アドレスプール機能 の特典クォータを申請してください。詳細については、「クォータセンターでのクォータの引き上げ」をご参照ください。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:CreatePublicIpAddressPool

    create

    *PublicIpAddressPool

    acs:vpc:{#regionId}:{#accountId}:publicipaddresspool/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Isp

    string

    任意

    回線タイプ。有効な値:

    • BGP (デフォルト): BGP (マルチ ISP) 回線。

    • BGP_PRO: BGP (マルチ ISP) プレミアム回線。

    BGP (マルチ ISP) 回線および BGP (マルチ ISP) プレミアム回線の詳細については、「EIP の回線タイプ」をご参照ください。

    • シングル ISP 帯域幅のホワイトリストユーザーの場合は、以下のタイプも選択できます。

      • ChinaTelecom: China Telecom

      • ChinaUnicom: China Unicom

      • ChinaMobile: China Mobile

      • ChinaTelecom_L2: China Telecom L2

      • ChinaUnicom_L2: China Unicom L2

      • ChinaMobile_L2: China Mobile L2

    • 中国 (杭州) 金融クラウドユーザーの場合、このパラメーターは必須です。値を BGP_FinanceCloud に設定してください。

    BGP
    Name

    string

    任意

    IP アドレスプールインスタンスの名前。

    名前の長さは 0～128 文字で、http:// または https:// で始まることはできません。

    AddressPoolName
    Description

    string

    任意

    IP アドレスプールインスタンスの説明。

    説明の長さは 0～256 文字で、http:// または https:// で始まることはできません。

    AddressPoolDescription
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。

    クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。

    説明

    このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。

    02fb3da4-130e-11****
    DryRun

    boolean

    任意

    ドライランを実行するかどうかを指定します。有効な値:

    • true: IP アドレスプールを作成せずにドライランを実行します。システムは必須パラメーター、リクエスト構文、およびビジネス制限をチェックします。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、DryRunOperation エラーコードが返されます。

    • false (デフォルト): ドライランを実行し、リクエストを送信します。チェックに成功した場合、HTTP 2xx 状態コードが返され、操作が実行されます。

    false
    ResourceGroupId

    string

    任意

    IP アドレスプールが属するリソースグループの ID。

    rg-acfmxazb4pcdvf****
    RegionId

    string

    必須

    作成する IP アドレスプールのリージョン ID。

    cn-chengdu
    BizType

    string

    任意

    IP アドレスプールのビジネスタイプ。有効な値:

    • CloudBox: CloudBox。CloudBox ユーザーのみがこのタイプを選択できます。

    • Default (デフォルト): 特殊ではないタイプを示します。

    Default
    Zones

    array

    任意

    IP アドレスプールのゾーン。 このパラメーターは、BizType が CloudBox に設定されている場合にのみ必須であり、IP アドレスプールのビジネスタイプが CloudBox であることを示します。

    string

    任意

    IP アドレスプールのゾーン。 このパラメーターは、BizType が CloudBox に設定されている場合にのみ必須であり、IP アドレスプールのビジネスタイプが CloudBox であることを示します。 指定できるゾーンは 1 つだけです。

    ap-southeast-1-lzdvn-cb
    Tag

    array<object>

    任意

    リソースのタグ。

    object

    任意

    タグ。

    Key

    string

    任意

    リソースのタグキー。最大 20 個のタグキーを指定できます。タグキーを空文字列にすることはできません。

    タグキーの長さは最大 128 文字で、aliyun または acs: で始まることはできません。また、http:// または https:// を含めることはできません。

    FinanceDept
    Value

    string

    任意

    リソースのタグ値。最大 20 個のタグ値を指定できます。タグ値は空文字列にすることができます。

    タグ値の長さは最大 128 文字で、aliyun または acs: で始まることはできません。また、http:// または https:// を含めることはできません。

    FinanceJoshua
    SecurityProtectionTypes

    array

    任意

    セキュリティ保護レベル。

    • このパラメーターが空のセットの場合、デフォルトで DDoS 攻撃対策 (Basic) が使用されます。

    • このパラメーターが AntiDDoS_Enhanced に設定されている場合、DDoS 攻撃対策 (Enhanced) が使用されます。

    string

    任意

    セキュリティ保護レベル。

    • このパラメーターが空のセットの場合、デフォルトで DDoS 攻撃対策 (Basic) が使用されます。

    • このパラメーターが AntiDDoS_Enhanced に設定されている場合、DDoS 攻撃対策 (Enhanced) が使用されます。

    AntiDDoS_Enhanced

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス構造体。

    PulbicIpAddressPoolId deprecated

    string

    IPAM プールのインスタンス ID。

    pippool-6wetvn6fumkgycssx****
    RequestId

    string

    リクエスト ID。

    4EC47282-1B74-4534-BD0E-403F3EE64CAF
    ResourceGroupId

    string

    IP アドレスプールが属するリソースグループの ID。

    rg-acfmxazb4pcdvf****
    PublicIpAddressPoolId

    string

    IPAM プールのインスタンス ID。

    pippool-6wetvn6fumkgycssx****

    例

    成功レスポンス

    JSONJSON

    {
  "PulbicIpAddressPoolId": "pippool-6wetvn6fumkgycssx****",
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "ResourceGroupId": "rg-acfmxazb4pcdvf****",
  "PublicIpAddressPoolId": "pippool-6wetvn6fumkgycssx****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IllegalParam.Isp The param of Isp [%s] is illegal. Isp パラメーターが無効です。リクエストパラメーターで指定されている有効な値を入力してください。
    400 IllegalParam.Name The param of Name [%s] is illegal. パラメーター Name が無効です。リクエストパラメーターの要件に従って有効な値を入力してください。
    400 IllegalParam.Description The param of Description [%s] is illegal. Description パラメーターが無効です。
    400 Forbidden.CreatePublicIpAddressPool Authentication is failed for creating public ip address pool. 現時点では PublicIpAddressPool を作成できません。アカウントにこの操作を実行する権限があるかどうかを確認してください。
    400 QuotaExceeded.PublicIpAddressPool The quota of PublicIpAddressPool is exceeded. PublicIpAddressPool インスタンスの数がクォータに達しました。続行する前にクォータを引き上げてください。
    400 MissingParam.Zones The Zones parameter is required. Zones パラメーターは必須です。
    400 IllegalParam.Zones The values of Zones [%s] are invalid. Zones パラメーターが無効です。
    400 IllegalParamSize.Zones An invalid number of zones is specified. Zones 配列のサイズが無効です。
    400 UnsupportedFeature.Isp The feature of Isp is not supported. 指定された Isp はサポートされていません。
    400 OperationDenied.ISPNotSupportDdosEnhanced The operation is not allowed because of DdosEnhanced is not supported by current isp. 現在の ISP は、拡張セキュリティ保護アドレスプールの作成をサポートしていません。
    400 IllegalParam.SecurityProtectionTypes The param of securityProtectionTypes is illegal. SecurityProtectionTypes パラメーターが無効です。
    400 IncorrectBusinessStatus.PublicIpAddressPool The business status of publicIpAddressPool is incorrect. 現在のサービスステータスでは、IP アドレスプールインスタンスの作成はサポートされていません。
    400 OptInRequired.PublicIpAddressPool You are not authorized to use the requested service of publicIpAddressPool. Ensure that you have subscribed to the service you are trying to use. リクエストされた IP Address Manager サービスを使用する権限がありません。サービスにサブスクライブ済みであることを確認してください。

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

    変更履歴

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