你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Workload Networks - Create Public IP
创建 WorkloadNetworkPublicIP
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/publicIPs/{publicIPId}?api-version=2023-09-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
private
|
path | True |
string |
私有云的名称 Regex pattern: |
public
|
path | True |
string |
DNS 区域的 ID。 Regex pattern: |
resource
|
path | True |
string |
资源组的名称。 此名称不区分大小写。 |
subscription
|
path | True |
string uuid |
目标订阅的 ID。 该值必须是 UUID。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
properties.displayName |
string |
公共 IP 块的显示名称。 |
properties.numberOfPublicIPs |
integer |
请求的公共 IP 数。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
资源“WorkloadNetworkPublicIP”更新操作成功 |
|
201 Created |
资源“WorkloadNetworkPublicIP”创建操作成功 Headers Retry-After: integer |
|
Other Status Codes |
意外的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
WorkloadNetworks_CreatePublicIP
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/workloadNetworks/default/publicIPs/publicIP1?api-version=2023-09-01
{
"properties": {
"displayName": "publicIP1",
"numberOfPublicIPs": 32
}
}
Sample Response
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/workloadNetworks/default/publicIPs/publicIP1",
"name": "publicIP1",
"properties": {
"displayName": "publicIP1",
"publicIPBlock": "20.20.40.50/32"
},
"type": "Microsoft.AVS/privateClouds/workloadNetworks/publicIPs"
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/workloadNetworks/default/publicIPs/publicIP1",
"name": "publicIP1",
"properties": {
"displayName": "publicIP1",
"publicIPBlock": "20.20.40.50/32"
},
"type": "Microsoft.AVS/privateClouds/workloadNetworks/publicIPs"
}
定义
名称 | 说明 |
---|---|
created |
创建资源的标识类型。 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
system |
与资源的创建和上次修改相关的元数据。 |
Workload |
NSX 公共 IP 块 |
Workload |
工作负载网络公共 IP 预配状态 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源的创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |
WorkloadNetworkPublicIP
NSX 公共 IP 块
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
name |
string |
资源的名称 |
properties.displayName |
string |
公共 IP 块的显示名称。 |
properties.numberOfPublicIPs |
integer |
请求的公共 IP 数。 |
properties.provisioningState |
预配状态 |
|
properties.publicIPBlock |
string |
公共 IP 块的 CIDR 块。 |
systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
WorkloadNetworkPublicIPProvisioningState
工作负载网络公共 IP 预配状态
名称 | 类型 | 说明 |
---|---|---|
Building |
string |
是建立 |
Canceled |
string |
资源创建已取消。 |
Deleting |
string |
正在删除 |
Failed |
string |
资源创建失败。 |
Succeeded |
string |
资源已创建。 |
Updating |
string |
正在更新 |