IPAM アドレスプールを作成します。
操作説明
ISP タイプごと、リージョンごとのパブリック IPv6 トップレベルプールのデフォルトの最大数は 1 です。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
IPAM のリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID を取得できます。 |
cn-hangzhou |
| IpamScopeId |
string |
必須 |
IPAM スコープのインスタンス ID。 |
ipam-scope-glfmcyldpm8lsy**** |
| IpamPoolName |
string |
任意 |
IPAM アドレスプールの名前。 名前は 1～128 文字で、 |
abc |
| IpamPoolDescription |
string |
任意 |
IPAM アドレスプールの説明。 説明は 1～256 文字で、英大文字、英小文字、または中国語の文字で始める必要があります。 |
test description |
| ResourceGroupId |
string |
任意 |
IPAM アドレスプールのリソースグループ ID。 |
rg-acfmxazb4ph6aiy**** |
| PoolRegionId |
string |
任意 |
IPAM アドレスプールが有効になるリージョン。 |
cn-hangzhou |
| SourceIpamPoolId |
string |
任意 |
ソース IPAM アドレスプールのインスタンス ID。 説明
このパラメーターを指定しない場合、作成されるアドレスプールはトップレベルアドレスプールになります。 |
ipam-pool-6rcq3tobayc20t**** |
| AllocationDefaultCidrMask |
integer |
任意 |
IPAM アドレスプールからの割り当てのデフォルト CIDR マスク。 説明
IPv4 CIDR マスクの範囲は 0～32 ビットです。IPv6 CIDR マスクの範囲は 0～128 ビットです。 |
28 |
| AllocationMaxCidrMask |
integer |
任意 |
IPAM アドレスプールからの割り当ての CIDR マスクの最大値。 説明
IPv4 CIDR マスクの範囲は 0～32 ビットです。IPv6 CIDR マスクの範囲は 0～128 ビットです。 |
32 |
| AllocationMinCidrMask |
integer |
任意 |
IPAM アドレスプールからの割り当ての CIDR マスクの最小値。 説明
IPv4 CIDR マスクの範囲は 0～32 ビットです。IPv6 CIDR マスクの範囲は 0～128 ビットです。 |
8 |
| DryRun |
boolean |
任意 |
実際のリクエストを実行せずにドライランのみを実行するかどうかを指定します。有効な値:
|
false |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。 |
123e4567-e89b-12d3-a456-426655440000 |
| IpVersion |
string |
任意 |
IP アドレスプロトコルバージョン。有効な値:
|
IPv4 |
| Ipv6Isp |
string |
任意 |
IPv6 CIDR ブロックのタイプ。このパラメーターはパブリック IPv6 アドレスプールに対してのみ有効です。有効な値:
説明
シングル回線帯域幅ホワイトリストを有効にしている場合、このフィールドは ChinaTelecom (China Telecom)、ChinaUnicom (China Unicom)、または ChinaMobile (China Mobile) に設定できます。 |
BGP |
| AutoImport |
boolean |
任意 |
アドレスプールの自動インポート機能を有効にするかどうかを指定します。 |
true |
| Tag |
array<object> |
任意 |
タグリスト。 |
|
|
object |
任意 |
タグ情報。 |
||
| Key |
string |
任意 |
リソースのタグキー。最大 20 個のタグキーがサポートされています。この値を指定した場合、空の文字列にすることはできません。 タグキーは最大 64 文字で、英字または中国語の文字で始める必要があります。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。 説明
ResourceId.N と Tag.N (Tag.N.Key および Tag.N.Value) パラメーターのうち、少なくとも 1 つを指定する必要があります。 |
FinanceDept |
| Value |
string |
任意 |
リソースのタグ値。最大 20 個のタグ値がサポートされています。この値を指定した場合、空の文字列にすることができます。 タグ値は最大 128 文字で、 説明
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. | |
| 400 | Mismatch.ChildIpVersionAndParentIpVersion | The ChildIpVersion and ParentIpVersion are mismatched. | |
| 400 | Mismatch.ChildPoolRegionAndParentPoolRegion | The ChildPoolRegion and ParentPoolRegion are mismatched. | |
| 400 | Mismatch.ChildIpamScopeAndParentIpamScope | The ChildIpamScope and ParentIpamScope are mismatched. | |
| 400 | Mismatch.ChildIpv6IspAndParentIpv6Isp | The ChildIpv6Isp and ParentIpv6Isp are mismatched. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。