すべてのプロダクト
Search

このプロダクト

    :CreateIpamPool

    ドキュメントセンター

    :CreateIpamPool

    最終更新日:Sep 22, 2025

    IPAM アドレスプールを作成します。

    操作説明

    • デフォルトでは、各リージョンでインターネットサービスプロバイダー (ISP) タイプごとに最大 1 つのトップレベルのパブリック IPv6 プールを作成できます。

    今すぐお試しください

    この 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:CreateIpamPool

    create

    *IpamPool

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    IPAM が管理されているリージョンの ID。 DescribeRegions 操作を呼び出して、リージョン ID を取得します。

    cn-hangzhou
    IpamScopeId

    string

    必須

    IPAM スコープの ID。

    ipam-scope-glfmcyldpm8lsy****
    IpamPoolName

    string

    任意

    IPAM アドレスプールの名前。

    名前は 1～128 文字で、http:// または https:// で始めることはできません。

    abc
    IpamPoolDescription

    string

    任意

    IPAM アドレスプールの説明。

    説明は 1～256 文字で、文字または漢字で始まる必要があります。http:// または https:// で始めることはできません。このパラメーターを指定しない場合、説明は空になります。

    test description
    ResourceGroupId

    string

    任意

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

    rg-acfmxazb4ph6aiy****
    PoolRegionId

    string

    任意

    IPAM アドレスプールが利用可能なリージョン。

    cn-hangzhou
    SourceIpamPoolId

    string

    任意

    ソース IPAM アドレスプールの ID。

    説明

    このパラメーターを指定しない場合、親アドレスプールが作成されます。

    ipam-pool-6rcq3tobayc20t****
    AllocationDefaultCidrMask

    integer

    任意

    IPAM アドレスプール内のアロケーションのデフォルトネットワークマスク。

    説明

    IPv4 アドレスプールのネットワークマスクは 0～32 の整数である必要があります。IPv6 アドレスプールのネットワークマスクは 0～128 の整数である必要があります。

    28
    AllocationMaxCidrMask

    integer

    任意

    IPAM アドレスプール内のアロケーションの最大ネットワークマスク。

    説明

    IPv4 アドレスプールのネットワークマスクは 0～32 の整数である必要があります。IPv6 アドレスプールのネットワークマスクは 0～128 の整数である必要があります。

    32
    AllocationMinCidrMask

    integer

    任意

    IPAM アドレスプール内のアロケーションの最小ネットワークマスク。

    説明

    IPv4 アドレスプールのネットワークマスクは 0～32 の整数である必要があります。IPv6 アドレスプールのネットワークマスクは 0～128 の整数である必要があります。

    8
    DryRun

    boolean

    任意

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

    • true: IPAM アドレスプールを作成せずにチェックリクエストを送信します。システムは、必須パラメーター、リクエストフォーマット、およびインスタンスのステータスをチェックします。チェックに失敗した場合、対応するエラーが返されます。チェックに合格した場合、`DryRunOperation` エラーコードが返されます。

    • false (デフォルト): 通常のリクエストを送信します。リクエストがチェックに合格すると、2xx HTTP ステータスコードが返され、操作が実行されます。

    false
    ClientToken

    string

    任意

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

    説明

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

    123e4567-e89b-12d3-a456-426655440000
    IpVersion

    string

    任意

    IP バージョン。有効な値:

    • IPv4: IPv4。

    • IPv6: IPv6。

    IPv4
    Ipv6Isp

    string

    任意

    IPv6 CIDR ブロックの回線タイプ。このパラメーターは、パブリック IPv6 アドレスプールに対してのみ有効です。有効な値:

    • BGP (デフォルト): Alibaba Cloud BGP IPv6。

    • ChinaMobile: China Mobile (単一回線)。

    • ChinaUnicom: China Unicom (単一回線)。

    • ChinaTelecom: China Telecom (単一回線)。

    説明

    単一回線帯域幅のホワイトリストに登録されているユーザーは、このパラメーターを ChinaTelecom、ChinaUnicom、または ChinaMobile に設定できます。

    BGP
    AutoImport

    boolean

    任意

    アドレスプールの自動インポート機能を有効にするかどうかを指定します。

    true
    Tag

    array<object>

    任意

    タグ。

    object

    任意

    タグ。

    Key

    string

    任意

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

    タグキーは最大 64 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。タグキーは、文字または漢字で始まる必要があり、aliyun または acs: で始めることはできません。タグキーに http:// または https:// を含めることはできません。

    説明

    ResourceId.N または Tag.N (Tag.N.Key および Tag.N.Value) パラメーターの少なくとも 1 つを指定する必要があります。

    FinanceDept
    Value

    string

    任意

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

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

    説明

    ResourceId.N または Tag.N (Tag.N.Key および Tag.N.Value) パラメーターの少なくとも 1 つを指定する必要があります。

    FinanceJoshua

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    BB2C39DE-CEB8-595A-981A-F2EFCBE7324E
    IpamPoolId

    string

    IPAM アドレスプールの ID。

    ipam-pool-6rcq3tobayc20t****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E",
  "IpamPoolId": "ipam-pool-6rcq3tobayc20t****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ResourceNotFound.IpamScope The specified resource of IPAM scope is not found.
    400 ResourceNotFound.SourceIpamPool The dependent source IPAM pool is not found.
    400 UnsupportedFeature.PublicIpamScopeType The feature of PublicIpamScopeType is not supported.
    400 IllegalParam.AllocationDefaultNetmask The specified AllocationDefaultNetmask is illegal.
    400 IllegalParam.AllocationMaxNetmask The specified AllocationMaxNetmask is illegal.
    400 IllegalParam.AllocationMinNetmask The specified AllocationMinNetmask is illegal.
    400 IllegalParam.IpVersion The specified IpVersion is illegal.
    400 QuotaExceeded.IpamPoolQuotaDepth The quota of IpamPoolQuotaDepth count is exceeded.
    400 ResourceNotFound.Ipam The specified resource of ipam is not found.
    400 IllegalParam.PoolRegionId The specified PoolRegionId is illegal.
    400 QuotaExceeded.IpamSubPoolQuotaPerIpamPool The quota of ipamSubPoolQuotaPerIpamPool count is exceeded.
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    400 IncorrectStatus.IpamPool The status of the IPAM pool is incorrect.
    400 OperationDenied.OperateShareResource The operation is not allowed because the instance is a shared resource.
    400 UnsupportedFeature.IpamPublicIpv4Pool The feature of public IPv4 pool is not supported in IPAM.
    400 OperationDenied.IpamPublicIpv6PoolNeedPoolRegion The public IPv6 pool cannot be created in IPAM when its pool region is empty.
    400 IllegalParam.Ipv6Isp The specified Ipv6Isp is illegal.
    400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported.
    400 UnsupportedRegion.Ipv6Isp The current region does not support this feature.
    400 QuotaExceeded.IpamPublicIpv6TopPoolQuotaPerRegionIsp The number of public IPv6 top pool in IPAM for this ISP owned by the user in this region exceeds the limit.
    400 Mismatch.IpamScopeAndSourceIpamPool The input source IPAM pool is not in the input IPAM scope.
    400 Mismatch.Ipv6IspAndSourceIpamPool The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.
    400 UnsupportedFeature.IpamIpv6 The feature of IPv6 is not supported in this region.

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

    変更履歴

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