ApiVersionSetArgs

data class ApiVersionSetArgs(val apiManagementName: Output<String>? = null, val description: Output<String>? = null, val displayName: Output<String>? = null, val name: Output<String>? = null, val resourceGroupName: Output<String>? = null, val versionHeaderName: Output<String>? = null, val versionQueryName: Output<String>? = null, val versioningScheme: Output<String>? = null) : ConvertibleToJava<ApiVersionSetArgs>

Manages an API Version Set within an API Management Service.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = new azure.core.ResourceGroup("example", {
name: "example-resources",
location: "West Europe",
});
const exampleService = new azure.apimanagement.Service("example", {
name: "example-apim",
location: example.location,
resourceGroupName: example.name,
publisherName: "pub1",
publisherEmail: "pub1@email.com",
skuName: "Developer_1",
});
const exampleApiVersionSet = new azure.apimanagement.ApiVersionSet("example", {
name: "example-apimapi-1_0_0",
resourceGroupName: example.name,
apiManagementName: exampleService.name,
displayName: "ExampleAPIVersionSet",
versioningScheme: "Segment",
});
import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
name="example-resources",
location="West Europe")
example_service = azure.apimanagement.Service("example",
name="example-apim",
location=example.location,
resource_group_name=example.name,
publisher_name="pub1",
publisher_email="pub1@email.com",
sku_name="Developer_1")
example_api_version_set = azure.apimanagement.ApiVersionSet("example",
name="example-apimapi-1_0_0",
resource_group_name=example.name,
api_management_name=example_service.name,
display_name="ExampleAPIVersionSet",
versioning_scheme="Segment")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
var example = new Azure.Core.ResourceGroup("example", new()
{
Name = "example-resources",
Location = "West Europe",
});
var exampleService = new Azure.ApiManagement.Service("example", new()
{
Name = "example-apim",
Location = example.Location,
ResourceGroupName = example.Name,
PublisherName = "pub1",
PublisherEmail = "pub1@email.com",
SkuName = "Developer_1",
});
var exampleApiVersionSet = new Azure.ApiManagement.ApiVersionSet("example", new()
{
Name = "example-apimapi-1_0_0",
ResourceGroupName = example.Name,
ApiManagementName = exampleService.Name,
DisplayName = "ExampleAPIVersionSet",
VersioningScheme = "Segment",
});
});
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/apimanagement"
"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
Name: pulumi.String("example-resources"),
Location: pulumi.String("West Europe"),
})
if err != nil {
return err
}
exampleService, err := apimanagement.NewService(ctx, "example", &apimanagement.ServiceArgs{
Name: pulumi.String("example-apim"),
Location: example.Location,
ResourceGroupName: example.Name,
PublisherName: pulumi.String("pub1"),
PublisherEmail: pulumi.String("pub1@email.com"),
SkuName: pulumi.String("Developer_1"),
})
if err != nil {
return err
}
_, err = apimanagement.NewApiVersionSet(ctx, "example", &apimanagement.ApiVersionSetArgs{
Name: pulumi.String("example-apimapi-1_0_0"),
ResourceGroupName: example.Name,
ApiManagementName: exampleService.Name,
DisplayName: pulumi.String("ExampleAPIVersionSet"),
VersioningScheme: pulumi.String("Segment"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.apimanagement.Service;
import com.pulumi.azure.apimanagement.ServiceArgs;
import com.pulumi.azure.apimanagement.ApiVersionSet;
import com.pulumi.azure.apimanagement.ApiVersionSetArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceGroup("example", ResourceGroupArgs.builder()
.name("example-resources")
.location("West Europe")
.build());
var exampleService = new Service("exampleService", ServiceArgs.builder()
.name("example-apim")
.location(example.location())
.resourceGroupName(example.name())
.publisherName("pub1")
.publisherEmail("pub1@email.com")
.skuName("Developer_1")
.build());
var exampleApiVersionSet = new ApiVersionSet("exampleApiVersionSet", ApiVersionSetArgs.builder()
.name("example-apimapi-1_0_0")
.resourceGroupName(example.name())
.apiManagementName(exampleService.name())
.displayName("ExampleAPIVersionSet")
.versioningScheme("Segment")
.build());
}
}
resources:
example:
type: azure:core:ResourceGroup
properties:
name: example-resources
location: West Europe
exampleService:
type: azure:apimanagement:Service
name: example
properties:
name: example-apim
location: ${example.location}
resourceGroupName: ${example.name}
publisherName: pub1
publisherEmail: pub1@email.com
skuName: Developer_1
exampleApiVersionSet:
type: azure:apimanagement:ApiVersionSet
name: example
properties:
name: example-apimapi-1_0_0
resourceGroupName: ${example.name}
apiManagementName: ${exampleService.name}
displayName: ExampleAPIVersionSet
versioningScheme: Segment

API Providers

This resource uses the following Azure API Providers:

  • Microsoft.ApiManagement: 2022-08-01

Import

API Version Set can be imported using the resource id, e.g.

$ pulumi import azure:apimanagement/apiVersionSet:ApiVersionSet example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.ApiManagement/service/service1/apiVersionSets/set1

Constructors

Link copied to clipboard
constructor(apiManagementName: Output<String>? = null, description: Output<String>? = null, displayName: Output<String>? = null, name: Output<String>? = null, resourceGroupName: Output<String>? = null, versionHeaderName: Output<String>? = null, versionQueryName: Output<String>? = null, versioningScheme: Output<String>? = null)

Properties

Link copied to clipboard
val apiManagementName: Output<String>? = null

The name of the API Management Service in which the API Version Set should exist. May only contain alphanumeric characters and dashes up to 50 characters in length. Changing this forces a new resource to be created.

Link copied to clipboard
val description: Output<String>? = null

The description of API Version Set.

Link copied to clipboard
val displayName: Output<String>? = null

The display name of this API Version Set.

Link copied to clipboard
val name: Output<String>? = null

The name of the API Version Set. May only contain alphanumeric characters and dashes up to 80 characters in length. Changing this forces a new resource to be created.

Link copied to clipboard
val resourceGroupName: Output<String>? = null

The name of the Resource Group in which the parent API Management Service exists. Changing this forces a new resource to be created.

Link copied to clipboard
val versionHeaderName: Output<String>? = null

The name of the Header which should be read from Inbound Requests which defines the API Version.

Link copied to clipboard
val versioningScheme: Output<String>? = null

Specifies where in an Inbound HTTP Request that the API Version should be read from. Possible values are Header, Query and Segment.

Link copied to clipboard
val versionQueryName: Output<String>? = null

The name of the Query String which should be read from Inbound Requests which defines the API Version.

Functions

Link copied to clipboard
open override fun toJava(): ApiVersionSetArgs