Udostępnij za pośrednictwem

Profiles - Create Or Update

  • Odwołanie
Usługa:
Traffic Manager
Wersja interfejsu API:
2022-04-01

Tworzenie lub aktualizowanie profilu usługi Traffic Manager.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}?api-version=2022-04-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
profileName
 path True

string

Nazwa profilu usługi Traffic Manager.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId
 path True

string

Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version
 query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}
location

string

Region świadczenia usługi Azure, w którym znajduje się zasób
name

string

Nazwa zasobu
properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Lista dozwolonych typów rekordów punktu końcowego.
properties.dnsConfig

DnsConfig

Ustawienia DNS profilu usługi Traffic Manager.
properties.endpoints

Endpoint[]

Lista punktów końcowych w profilu usługi Traffic Manager.
properties.maxReturn

integer (int64)

Maksymalna liczba punktów końcowych, które mają być zwracane dla typu routingu MultiValue.
properties.monitorConfig

MonitorConfig

Ustawienia monitorowania punktu końcowego profilu usługi Traffic Manager.
properties.profileStatus

ProfileStatus

Stan profilu usługi Traffic Manager.
properties.trafficRoutingMethod

TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.
properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu ma wartość "Włączone" lub "Wyłączone" dla profilu usługi Traffic Manager. Wartość null wskazuje wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.
tags

object

Tagi zasobów.
type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

Odpowiedzi

Nazwa Typ Opis
200 OK

Profile

Utworzony lub zaktualizowany profil usługi Traffic Manager.
201 Created

Profile

Utworzony lub zaktualizowany profil usługi Traffic Manager.
Other Status Codes

CloudError

Odpowiedź domyślna. Zostanie on zdeserializowany zgodnie z definicją Błędu.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Profile-PUT-MultiValue
Profile-PUT-NoEndpoints
Profile-PUT-WithAliasing
Profile-PUT-WithCustomHeaders
Profile-PUT-WithEndpoints
Profile-PUT-WithNestedEndpoints

Profile-PUT-MultiValue

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficmanagerprofiles/azsmnet6386?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "MultiValue",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx"
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "maxReturn": 2
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386",
  "name": "azsmnet6386",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "MultiValue",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "fqdn": "azsmnet6386.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "Inactive",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "maxReturn": 2,
    "endpoints": []
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386",
  "name": "azsmnet6386",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "MultiValue",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "fqdn": "azsmnet6386.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "Inactive",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "maxReturn": 2,
    "endpoints": []
  }
}

Profile-PUT-NoEndpoints

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficmanagerprofiles/azsmnet6386?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx"
    }
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386",
  "name": "azsmnet6386",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "fqdn": "azsmnet6386.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "Inactive",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "endpoints": []
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386",
  "name": "azsmnet6386",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azsmnet6386",
      "fqdn": "azsmnet6386.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "Inactive",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "endpoints": []
  }
}

Profile-PUT-WithAliasing

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager6192?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "timeoutInSeconds": 5,
      "toleratedNumberOfFailures": 2
    },
    "allowedEndpointRecordTypes": [
      "DomainName"
    ],
    "endpoints": [
      {
        "name": "My external endpoint",
        "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
        "properties": {
          "target": "foobar.contoso.com",
          "endpointStatus": "Enabled",
          "endpointLocation": "North Europe"
        }
      }
    ]
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5,
      "customHeaders": [
        {
          "name": "header-1",
          "value": "value-1"
        },
        {
          "name": "header-2",
          "value": "value-2"
        }
      ]
    },
    "allowedEndpointRecordTypes": [
      "DomainName"
    ],
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe",
          "customHeaders": [
            {
              "name": "header-2",
              "value": "value-2-overridden"
            }
          ]
        }
      }
    ]
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5,
      "customHeaders": [
        {
          "name": "header-1",
          "value": "value-1"
        },
        {
          "name": "header-2",
          "value": "value-2"
        }
      ]
    },
    "allowedEndpointRecordTypes": [
      "DomainName"
    ],
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe",
          "customHeaders": [
            {
              "name": "header-2",
              "value": "value-2-overridden"
            }
          ]
        }
      }
    ]
  }
}

Profile-PUT-WithCustomHeaders

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager6192?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "timeoutInSeconds": 5,
      "toleratedNumberOfFailures": 2,
      "customHeaders": [
        {
          "name": "header-1",
          "value": "value-1"
        },
        {
          "name": "header-2",
          "value": "value-2"
        }
      ],
      "expectedStatusCodeRanges": [
        {
          "min": 200,
          "max": 205
        },
        {
          "min": 400,
          "max": 410
        }
      ]
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "endpoints": [
      {
        "name": "My external endpoint",
        "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
        "properties": {
          "target": "foobar.contoso.com",
          "endpointStatus": "Enabled",
          "endpointLocation": "North Europe",
          "customHeaders": [
            {
              "name": "header-2",
              "value": "value-2-overridden"
            }
          ]
        }
      }
    ]
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5,
      "customHeaders": [
        {
          "name": "header-1",
          "value": "value-1"
        },
        {
          "name": "header-2",
          "value": "value-2"
        }
      ]
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe",
          "customHeaders": [
            {
              "name": "header-2",
              "value": "value-2-overridden"
            }
          ]
        }
      }
    ]
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5,
      "customHeaders": [
        {
          "name": "header-1",
          "value": "value-1"
        },
        {
          "name": "header-2",
          "value": "value-2"
        }
      ]
    },
    "trafficViewEnrollmentStatus": "Disabled",
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe",
          "customHeaders": [
            {
              "name": "header-2",
              "value": "value-2-overridden"
            }
          ]
        }
      }
    ]
  }
}

Profile-PUT-WithEndpoints

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager6192?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "timeoutInSeconds": 5,
      "toleratedNumberOfFailures": 2
    },
    "endpoints": [
      {
        "name": "My external endpoint",
        "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
        "properties": {
          "target": "foobar.contoso.com",
          "endpointStatus": "Enabled",
          "endpointLocation": "North Europe"
        }
      }
    ]
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe"
        }
      }
    ]
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
  "name": "azuresdkfornetautoresttrafficmanager6192",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager6192",
      "fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/externalEndpoints/My external endpoint",
        "name": "My external endpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "foobar.contoso.com",
          "weight": 1,
          "priority": 1,
          "endpointLocation": "North Europe"
        }
      }
    ]
  }
}

Profile-PUT-WithNestedEndpoints

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficmanagerprofiles/parentprofile?api-version=2022-04-01

{
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Priority",
    "dnsConfig": {
      "relativeName": "parentprofile",
      "ttl": 35
    },
    "monitorConfig": {
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "timeoutInSeconds": 5,
      "toleratedNumberOfFailures": 2
    },
    "endpoints": [
      {
        "name": "MyFirstNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "target": "firstnestedprofile.tmpreview.watmtest.azure-test.net",
          "endpointStatus": "Enabled",
          "weight": 1,
          "priority": 1,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 1,
          "minChildEndpointsIPv6": 2
        }
      },
      {
        "name": "MySecondNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "target": "secondnestedprofile.tmpreview.watmtest.azure-test.net",
          "endpointStatus": "Enabled",
          "weight": 1,
          "priority": 2,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 2,
          "minChildEndpointsIPv6": 1
        }
      }
    ]
  },
  "location": "global"
}

Przykładowa odpowiedź

Kod stanu:
201 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile",
  "name": "parentprofile",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Priority",
    "dnsConfig": {
      "relativeName": "parentprofile",
      "fqdn": "parentprofile.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile/nestedEndpoints/MyFirstNestedEndpoint",
        "name": "MyFirstNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "firstnestedprofile.tmpreview.watmtest.azure-test.net",
          "weight": 1,
          "priority": 1,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 1,
          "minChildEndpointsIPv6": 2
        }
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile/nestedEndpoints/MySecondNestedEndpoint",
        "name": "MySecondNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "secondnestedprofile.tmpreview.watmtest.azure-test.net",
          "weight": 1,
          "priority": 1,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 2,
          "minChildEndpointsIPv6": 1
        }
      }
    ]
  }
}
Kod stanu:
200 
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile",
  "name": "parentprofile",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Priority",
    "dnsConfig": {
      "relativeName": "parentprofile",
      "fqdn": "parentprofile.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 10,
      "toleratedNumberOfFailures": 2,
      "timeoutInSeconds": 5
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile/nestedEndpoints/MyFirstNestedEndpoint",
        "name": "MyFirstNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "firstnestedprofile.tmpreview.watmtest.azure-test.net",
          "weight": 1,
          "priority": 1,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 1,
          "minChildEndpointsIPv6": 2
        }
      },
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.Network/trafficManagerProfiles/parentprofile/nestedEndpoints/MySecondNestedEndpoint",
        "name": "MySecondNestedEndpoint",
        "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
        "properties": {
          "endpointStatus": "Enabled",
          "endpointMonitorStatus": "CheckingEndpoint",
          "target": "secondnestedprofile.tmpreview.watmtest.azure-test.net",
          "weight": 1,
          "priority": 1,
          "minChildEndpoints": 2,
          "minChildEndpointsIPv4": 2,
          "minChildEndpointsIPv6": 1
        }
      }
    ]
  }
}

Definicje

Nazwa Opis
AllowedEndpointRecordType

Dozwolony typ typów rekordów DNS dla tego profilu.
AlwaysServe

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.
CloudError

Błąd zwrócony przez usługę Azure Resource Manager
CloudErrorBody

Zawartość błędu zwróconego przez usługę Azure Resource Manager
CustomHeaders

Lista nagłówków niestandardowych.
DnsConfig

Klasa zawierająca ustawienia DNS w profilu usługi Traffic Manager.
Endpoint

Klasa reprezentująca punkt końcowy usługi Traffic Manager.
EndpointMonitorStatus

Stan monitorowania punktu końcowego.
EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.
ExpectedStatusCodeRanges

Lista oczekiwanych zakresów kodu stanu.
MonitorConfig

Klasa zawierająca ustawienia monitorowania punktu końcowego w profilu usługi Traffic Manager.
MonitorProtocol

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.
Profile

Klasa reprezentująca profil usługi Traffic Manager.
ProfileMonitorStatus

Stan monitorowania na poziomie profilu profilu usługi Traffic Manager.
ProfileStatus

Stan profilu usługi Traffic Manager.
Subnets

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.
TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.
TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu ma wartość "Włączone" lub "Wyłączone" dla profilu usługi Traffic Manager. Wartość null wskazuje wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.

AllowedEndpointRecordType

Wyliczanie

Dozwolony typ typów rekordów DNS dla tego profilu.

Wartość Opis
Any
DomainName
IPv4Address
IPv6Address

AlwaysServe

Wyliczanie

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

Wartość Opis
Disabled
Enabled

CloudError

Objekt

Błąd zwrócony przez usługę Azure Resource Manager

Nazwa Typ Opis
error

CloudErrorBody

Zawartość błędu.

CloudErrorBody

Objekt

Zawartość błędu zwróconego przez usługę Azure Resource Manager

Nazwa Typ Opis
code

string

Kod błędu
details

CloudErrorBody[]

Szczegóły błędu
message

string

Komunikat o błędzie
target

string

Cel błędu

CustomHeaders

Objekt

Lista nagłówków niestandardowych.

Nazwa Typ Opis
name

string

Nazwa nagłówka.
value

string

Wartość nagłówka.

DnsConfig

Objekt

Klasa zawierająca ustawienia DNS w profilu usługi Traffic Manager.

Nazwa Typ Opis
fqdn

string

W pełni kwalifikowana nazwa domeny (FQDN) profilu usługi Traffic Manager. Jest to tworzone na podstawie łączenia parametru RelativeName z domeną DNS używaną przez usługę Azure Traffic Manager.
relativeName

string

Względna nazwa DNS podana przez ten profil usługi Traffic Manager. Ta wartość jest połączona z nazwą domeny DNS używaną przez usługę Azure Traffic Manager w celu utworzenia w pełni kwalifikowanej nazwy domeny (FQDN) profilu.
ttl

integer (int64)

Czas DNS —To-Live (TTL) w sekundach. Informuje to lokalne narzędzia rozpoznawania nazw DNS i klientów DNS, jak długo buforować odpowiedzi DNS dostarczone przez ten profil usługi Traffic Manager.

Endpoint

Objekt

Klasa reprezentująca punkt końcowy usługi Traffic Manager.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}
name

string

Nazwa zasobu
properties.alwaysServe

AlwaysServe

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.
properties.customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.
properties.endpointLocation

string

Określa lokalizację zewnętrznych lub zagnieżdżonych punktów końcowych podczas korzystania z metody routingu ruchu "Wydajność".
properties.endpointMonitorStatus

EndpointMonitorStatus

Stan monitorowania punktu końcowego.
properties.endpointStatus

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.
properties.geoMapping

string[]

Lista krajów/regionów zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu geograficznego. Aby uzyskać pełną listę akceptowanych wartości, zapoznaj się z dokumentacją geograficzną usługi Traffic Manager.
properties.minChildEndpoints

integer (int64)

Minimalna liczba punktów końcowych, które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".
properties.minChildEndpointsIPv4

integer (int64)

Minimalna liczba punktów końcowych IPv4 (typ rekordu DNS A), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".
properties.minChildEndpointsIPv6

integer (int64)

Minimalna liczba punktów końcowych IPv6 (typu rekordu DNS AAAA), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".
properties.priority

integer (int64)

Priorytet tego punktu końcowego podczas korzystania z metody routingu ruchu "Priorytet". Możliwe wartości to od 1 do 1000, niższe wartości reprezentują wyższy priorytet. Jest to opcjonalny parametr. Jeśli zostanie określony, musi być określony we wszystkich punktach końcowych, a żadne dwa punkty końcowe nie mogą współdzielić tej samej wartości priorytetu.
properties.subnets

Subnets[]

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.
properties.target

string

W pełni kwalifikowana nazwa DNS lub adres IP punktu końcowego. Usługa Traffic Manager zwraca tę wartość w odpowiedziach DNS, aby kierować ruch do tego punktu końcowego.
properties.targetResourceId

string

Identyfikator URI zasobu platformy Azure punktu końcowego. Nie dotyczy punktów końcowych typu "ExternalEndpoints".
properties.weight

integer (int64)

Waga tego punktu końcowego podczas korzystania z metody routingu ruchu ważonego. Możliwe wartości to od 1 do 1000.
type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Wyliczanie

Stan monitorowania punktu końcowego.

Wartość Opis
CheckingEndpoint
Degraded
Disabled
Inactive
Online
Stopped
Unmonitored

EndpointStatus

Wyliczanie

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

Wartość Opis
Disabled
Enabled

ExpectedStatusCodeRanges

Objekt

Lista oczekiwanych zakresów kodu stanu.

Nazwa Typ Opis
max

integer

Maksymalny kod stanu.
min

integer

Minimalny kod stanu.

MonitorConfig

Objekt

Klasa zawierająca ustawienia monitorowania punktu końcowego w profilu usługi Traffic Manager.

Nazwa Typ Opis
customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.
expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Lista oczekiwanych zakresów kodu stanu.
intervalInSeconds

integer (int64)

Interwał monitorowania punktów końcowych w tym profilu. Jest to interwał, w którym usługa Traffic Manager sprawdzi kondycję każdego punktu końcowego w tym profilu.
path

string

Ścieżka względem nazwy domeny punktu końcowego używanej do sondowania kondycji punktu końcowego.
port

integer (int64)

Port TCP używany do sondowania kondycji punktu końcowego.
profileMonitorStatus

ProfileMonitorStatus

Stan monitorowania na poziomie profilu profilu usługi Traffic Manager.
protocol

MonitorProtocol

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.
timeoutInSeconds

integer (int64)

Limit czasu monitorowania punktów końcowych w tym profilu. Jest to czas, w jaki usługa Traffic Manager zezwala punktom końcowym w tym profilu na odpowiedź na kontrolę kondycji.
toleratedNumberOfFailures

integer (int64)

Liczba kolejnych nieudanych kontroli kondycji tolerowanych przez usługę Traffic Manager przed zadeklarowaniem punktu końcowego w tym profilu Obniżona wydajność po następnym nieudanym sprawdzeniu kondycji.

MonitorProtocol

Wyliczanie

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.

Wartość Opis
HTTP
HTTPS
TCP

Profile

Objekt

Klasa reprezentująca profil usługi Traffic Manager.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}
location

string

Region świadczenia usługi Azure, w którym znajduje się zasób
name

string

Nazwa zasobu
properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Lista dozwolonych typów rekordów punktu końcowego.
properties.dnsConfig

DnsConfig

Ustawienia DNS profilu usługi Traffic Manager.
properties.endpoints

Endpoint[]

Lista punktów końcowych w profilu usługi Traffic Manager.
properties.maxReturn

integer (int64)

Maksymalna liczba punktów końcowych, które mają być zwracane dla typu routingu MultiValue.
properties.monitorConfig

MonitorConfig

Ustawienia monitorowania punktu końcowego profilu usługi Traffic Manager.
properties.profileStatus

ProfileStatus

Stan profilu usługi Traffic Manager.
properties.trafficRoutingMethod

TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.
properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu ma wartość "Włączone" lub "Wyłączone" dla profilu usługi Traffic Manager. Wartość null wskazuje wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.
tags

object

Tagi zasobów.
type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

ProfileMonitorStatus

Wyliczanie

Stan monitorowania na poziomie profilu profilu usługi Traffic Manager.

Wartość Opis
CheckingEndpoints
Degraded
Disabled
Inactive
Online

ProfileStatus

Wyliczanie

Stan profilu usługi Traffic Manager.

Wartość Opis
Disabled
Enabled

Subnets

Objekt

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

Nazwa Typ Opis
first

string

Pierwszy adres w podsieci.
last

string

Ostatni adres w podsieci.
scope

integer

Rozmiar bloku (liczba bitów wiodących w masce podsieci).

TrafficRoutingMethod

Wyliczanie

Metoda routingu ruchu profilu usługi Traffic Manager.

Wartość Opis
Geographic
MultiValue
Performance
Priority
Subnet
Weighted

TrafficViewEnrollmentStatus

Wyliczanie

Wskazuje, czy widok ruchu ma wartość "Włączone" lub "Wyłączone" dla profilu usługi Traffic Manager. Wartość null wskazuje wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.

Wartość Opis
Disabled
Enabled