Origin Groups - Create

Referensi

Service:: CDN

API Version:: 2023-05-01

Membuat grup asal baru dalam titik akhir yang ditentukan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}?api-version=2023-05-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpointName	path	True	string	Nama titik akhir di bawah profil yang unik secara global.
originGroupName	path	True	string	Nama grup asal yang unik dalam titik akhir.
profileName	path	True	string	Nama profil CDN yang unik dalam grup sumber daya.
resourceGroupName	path	True	string	Nama grup Sumber Daya dalam langganan Azure. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	ID Langganan Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2023-05-01.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
properties.origins	True	ResourceReference[]	Sumber konten yang dikirimkan melalui CDN dalam grup asal tertentu.
properties.healthProbeSettings		HealthProbeParameters	Pengaturan pemeriksaan kesehatan ke asal yang digunakan untuk menentukan kesehatan asal.
properties.responseBasedOriginErrorDetectionSettings		ResponseBasedOriginErrorDetectionParameters	Objek JSON yang berisi properti untuk menentukan kesehatan asal menggunakan permintaan/respons nyata. Properti ini saat ini tidak didukung.
properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes		integer	Waktu dalam menit untuk mengalihkan lalu lintas ke titik akhir secara bertahap ketika titik akhir yang tidak sehat menjadi sehat atau titik akhir baru ditambahkan. Defaultnya adalah 10 menit. Properti ini saat ini tidak didukung.

Respons

Nama	Jenis	Deskripsi
200 OK	OriginGroup	OK. Permintaan telah berhasil.
201 Created	OriginGroup	Dibuat. Permintaan telah dipenuhi dan grup asal baru telah dibuat.
202 Accepted	OriginGroup	Diterima dan operasi akan selesai secara asinkron. Headers location: string
Other Status Codes	ErrorResponse	Respons kesalahan CDN yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

OriginGroups_Create

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/origingroup1?api-version=2023-05-01

{
  "properties": {
    "healthProbeSettings": {
      "probePath": "/health.aspx",
      "probeRequestType": "GET",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 120
    },
    "origins": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
      }
    ],
    "responseBasedOriginErrorDetectionSettings": {
      "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
      "responseBasedFailoverThresholdPercentage": 10
    }
  }
}


import com.azure.resourcemanager.cdn.fluent.models.OriginGroupInner;
import com.azure.resourcemanager.cdn.models.HealthProbeParameters;
import com.azure.resourcemanager.cdn.models.HealthProbeRequestType;
import com.azure.resourcemanager.cdn.models.ProbeProtocol;
import com.azure.resourcemanager.cdn.models.ResourceReference;
import com.azure.resourcemanager.cdn.models.ResponseBasedDetectedErrorTypes;
import com.azure.resourcemanager.cdn.models.ResponseBasedOriginErrorDetectionParameters;
import java.util.Arrays;

/** Samples for OriginGroups Create. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/OriginGroups_Create.json
     */
    /**
     * Sample code: OriginGroups_Create.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void originGroupsCreate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cdnProfiles().manager().serviceClient().getOriginGroups().create("RG", "profile1", "endpoint1",
            "origingroup1",
            new OriginGroupInner()
                .withHealthProbeSettings(new HealthProbeParameters().withProbePath("/health.aspx")
                    .withProbeRequestType(HealthProbeRequestType.GET).withProbeProtocol(ProbeProtocol.HTTP)
                    .withProbeIntervalInSeconds(120))
                .withOrigins(Arrays.asList(new ResourceReference().withId(
                    "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1")))
                .withResponseBasedOriginErrorDetectionSettings(new ResponseBasedOriginErrorDetectionParameters()
                    .withResponseBasedDetectedErrorTypes(ResponseBasedDetectedErrorTypes.TCP_ERRORS_ONLY)
                    .withResponseBasedFailoverThresholdPercentage(10)),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.cdn import CdnManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cdn
# USAGE
    python origin_groups_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CdnManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.origin_groups.begin_create(
        resource_group_name="RG",
        profile_name="profile1",
        endpoint_name="endpoint1",
        origin_group_name="origingroup1",
        origin_group={
            "properties": {
                "healthProbeSettings": {
                    "probeIntervalInSeconds": 120,
                    "probePath": "/health.aspx",
                    "probeProtocol": "Http",
                    "probeRequestType": "GET",
                },
                "origins": [
                    {
                        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
                    }
                ],
                "responseBasedOriginErrorDetectionSettings": {
                    "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
                    "responseBasedFailoverThresholdPercentage": 10,
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/OriginGroups_Create.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcdn_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cdn/armcdn/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7b551033155a63739b6d28f79b9c07569f6179b8/specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/OriginGroups_Create.json
func ExampleOriginGroupsClient_BeginCreate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcdn.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewOriginGroupsClient().BeginCreate(ctx, "RG", "profile1", "endpoint1", "origingroup1", armcdn.OriginGroup{
		Properties: &armcdn.OriginGroupProperties{
			HealthProbeSettings: &armcdn.HealthProbeParameters{
				ProbeIntervalInSeconds: to.Ptr[int32](120),
				ProbePath:              to.Ptr("/health.aspx"),
				ProbeProtocol:          to.Ptr(armcdn.ProbeProtocolHTTP),
				ProbeRequestType:       to.Ptr(armcdn.HealthProbeRequestTypeGET),
			},
			Origins: []*armcdn.ResourceReference{
				{
					ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"),
				}},
			ResponseBasedOriginErrorDetectionSettings: &armcdn.ResponseBasedOriginErrorDetectionParameters{
				ResponseBasedDetectedErrorTypes:          to.Ptr(armcdn.ResponseBasedDetectedErrorTypesTCPErrorsOnly),
				ResponseBasedFailoverThresholdPercentage: to.Ptr[int32](10),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.OriginGroup = armcdn.OriginGroup{
	// 	Name: to.Ptr("origingroup1"),
	// 	Type: to.Ptr("Microsoft.Cdn/profiles/endpoints/origingroups"),
	// 	ID: to.Ptr("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"),
	// 	Properties: &armcdn.OriginGroupProperties{
	// 		HealthProbeSettings: &armcdn.HealthProbeParameters{
	// 			ProbeIntervalInSeconds: to.Ptr[int32](120),
	// 			ProbePath: to.Ptr("/health.aspx"),
	// 			ProbeProtocol: to.Ptr(armcdn.ProbeProtocolHTTP),
	// 			ProbeRequestType: to.Ptr(armcdn.HealthProbeRequestTypeGET),
	// 		},
	// 		Origins: []*armcdn.ResourceReference{
	// 			{
	// 				ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"),
	// 		}},
	// 		ResponseBasedOriginErrorDetectionSettings: &armcdn.ResponseBasedOriginErrorDetectionParameters{
	// 			ResponseBasedDetectedErrorTypes: to.Ptr(armcdn.ResponseBasedDetectedErrorTypesTCPErrorsOnly),
	// 			ResponseBasedFailoverThresholdPercentage: to.Ptr[int32](10),
	// 		},
	// 		ProvisioningState: to.Ptr(armcdn.OriginGroupProvisioningStateSucceeded),
	// 		ResourceState: to.Ptr(armcdn.OriginGroupResourceStateActive),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { CdnManagementClient } = require("@azure/arm-cdn");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates a new origin group within the specified endpoint.
 *
 * @summary Creates a new origin group within the specified endpoint.
 * x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/OriginGroups_Create.json
 */
async function originGroupsCreate() {
  const subscriptionId = process.env["CDN_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["CDN_RESOURCE_GROUP"] || "RG";
  const profileName = "profile1";
  const endpointName = "endpoint1";
  const originGroupName = "origingroup1";
  const originGroup = {
    healthProbeSettings: {
      probeIntervalInSeconds: 120,
      probePath: "/health.aspx",
      probeProtocol: "Http",
      probeRequestType: "GET",
    },
    origins: [
      {
        id: "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1",
      },
    ],
    responseBasedOriginErrorDetectionSettings: {
      responseBasedDetectedErrorTypes: "TcpErrorsOnly",
      responseBasedFailoverThresholdPercentage: 10,
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new CdnManagementClient(credential, subscriptionId);
  const result = await client.originGroups.beginCreateAndWait(
    resourceGroupName,
    profileName,
    endpointName,
    originGroupName,
    originGroup
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "name": "origingroup1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
  "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "healthProbeSettings": {
      "probePath": "/health.aspx",
      "probeRequestType": "GET",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 120
    },
    "origins": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
      }
    ],
    "responseBasedOriginErrorDetectionSettings": {
      "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
      "responseBasedFailoverThresholdPercentage": 10
    }
  }
}

Status code:: 201

{
  "name": "origingroup1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
  "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "healthProbeSettings": {
      "probePath": "/health.aspx",
      "probeRequestType": "GET",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 120
    },
    "origins": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
      }
    ],
    "responseBasedOriginErrorDetectionSettings": {
      "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
      "responseBasedFailoverThresholdPercentage": 10
    }
  }
}

Status code:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2023-05-01

Response Body

{
  "name": "originGroup1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1",
  "type": "Microsoft.Cdn/profiles/endpoints/origingroups",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "healthProbeSettings": {
      "probePath": "/health.aspx",
      "probeRequestType": "GET",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 120
    },
    "origins": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
      }
    ],
    "responseBasedOriginErrorDetectionSettings": {
      "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
      "responseBasedFailoverThresholdPercentage": 10
    }
  }
}

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
HealthProbeParameters	Objek JSON yang berisi properti untuk mengirim pemeriksaan kesehatan ke asal.
HealthProbeRequestType	Jenis permintaan pemeriksaan kesehatan yang dibuat.
HttpErrorRangeParameters	Objek JSON yang mewakili rentang untuk kode status http
IdentityType	Jenis identitas yang membuat/memodifikasi sumber daya
OriginGroup	Grup asal yang terdiri dari asal digunakan untuk penyeimbangan beban ke asal ketika konten tidak dapat dilayani dari CDN.
OriginGroupProvisioningState	Status provisi grup asal.
OriginGroupResourceState	Status sumber daya grup asal.
ProbeProtocol	Protokol yang digunakan untuk pemeriksaan kesehatan.
ResourceReference	Referensi ke sumber daya lain.
ResponseBasedDetectedErrorTypes	Jenis kesalahan respons untuk permintaan pengguna nyata yang asalnya akan dianggap tidak sehat
ResponseBasedOriginErrorDetectionParameters	Objek JSON yang berisi properti untuk menentukan kesehatan asal menggunakan permintaan/respons nyata.
SystemData	Membaca data sistem saja

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

HealthProbeParameters

Objek JSON yang berisi properti untuk mengirim pemeriksaan kesehatan ke asal.

Nama	Jenis	Deskripsi
probeIntervalInSeconds	integer	Jumlah detik antara pemeriksaan kesehatan. Defaultnya adalah 240 detik.
probePath	string	Jalur relatif terhadap asal yang digunakan untuk menentukan kesehatan asal.
probeProtocol	ProbeProtocol	Protokol yang digunakan untuk pemeriksaan kesehatan.
probeRequestType	HealthProbeRequestType	Jenis permintaan pemeriksaan kesehatan yang dibuat.

HealthProbeRequestType

Jenis permintaan pemeriksaan kesehatan yang dibuat.

Nama	Jenis	Deskripsi
GET	string
HEAD	string
NotSet	string

HttpErrorRangeParameters

Objek JSON yang mewakili rentang untuk kode status http

Nama	Jenis	Deskripsi
begin	integer	Awal inklusif dari rentang kode status http.
end	integer	Akhir inklusif dari rentang kode status http.

IdentityType

Jenis identitas yang membuat/memodifikasi sumber daya

Nama	Jenis	Deskripsi
application	string
key	string
managedIdentity	string
user	string

OriginGroup

Grup asal yang terdiri dari asal digunakan untuk penyeimbangan beban ke asal ketika konten tidak dapat dilayani dari CDN.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.healthProbeSettings	HealthProbeParameters	Pengaturan pemeriksaan kesehatan ke asal yang digunakan untuk menentukan kesehatan asal.
properties.origins	ResourceReference[]	Sumber konten yang dikirimkan melalui CDN dalam grup asal tertentu.
properties.provisioningState	OriginGroupProvisioningState	Status provisi grup asal.
properties.resourceState	OriginGroupResourceState	Status sumber daya grup asal.
properties.responseBasedOriginErrorDetectionSettings	ResponseBasedOriginErrorDetectionParameters	Objek JSON yang berisi properti untuk menentukan kesehatan asal menggunakan permintaan/respons nyata. Properti ini saat ini tidak didukung.
properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes	integer	Waktu dalam menit untuk mengalihkan lalu lintas ke titik akhir secara bertahap ketika titik akhir yang tidak sehat menjadi sehat atau titik akhir baru ditambahkan. Defaultnya adalah 10 menit. Properti ini saat ini tidak didukung.
systemData	SystemData	Membaca data sistem saja
type	string	Jenis sumber daya

OriginGroupProvisioningState

Status provisi grup asal.

Nama	Jenis	Deskripsi
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

OriginGroupResourceState

Status sumber daya grup asal.

Nama	Jenis	Deskripsi
Active	string
Creating	string
Deleting	string

ProbeProtocol

Protokol yang digunakan untuk pemeriksaan kesehatan.

Nama	Jenis	Deskripsi
Http	string
Https	string
NotSet	string

ResourceReference

Referensi ke sumber daya lain.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.

ResponseBasedDetectedErrorTypes

Jenis kesalahan respons untuk permintaan pengguna nyata yang asalnya akan dianggap tidak sehat

Nama	Jenis	Deskripsi
None	string
TcpAndHttpErrors	string
TcpErrorsOnly	string

ResponseBasedOriginErrorDetectionParameters

Objek JSON yang berisi properti untuk menentukan kesehatan asal menggunakan permintaan/respons nyata.

Nama	Jenis	Deskripsi
httpErrorRanges	HttpErrorRangeParameters[]	Daftar rentang kode status Http yang dianggap sebagai kesalahan server untuk asal dan ditandai sebagai tidak sehat.
responseBasedDetectedErrorTypes	ResponseBasedDetectedErrorTypes	Jenis kesalahan respons untuk permintaan pengguna nyata yang asalnya akan dianggap tidak sehat
responseBasedFailoverThresholdPercentage	integer	Persentase permintaan yang gagal dalam sampel di mana failover harus dipicu.

SystemData

Membaca data sistem saja

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC)
createdBy	string	Pengidentifikasi untuk identitas yang membuat sumber daya
createdByType	IdentityType	Jenis identitas yang membuat sumber daya
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Pengidentifikasi untuk identitas yang terakhir mengubah sumber daya
lastModifiedByType	IdentityType	Jenis identitas yang terakhir mengubah sumber daya

Origin Groups - Create

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Scopes

Contoh

OriginGroups_Create

Sample Request

Sample Response

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HealthProbeParameters

HealthProbeRequestType

HttpErrorRangeParameters

IdentityType

OriginGroup

OriginGroupProvisioningState

OriginGroupResourceState

ProbeProtocol

ResourceReference

ResponseBasedDetectedErrorTypes

ResponseBasedOriginErrorDetectionParameters

SystemData

Sumber Daya Tambahan: