Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.azure.apimanagement.kotlin
import com.pulumi.azure.apimanagement.ApiArgs.builder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiContactArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiContactArgsBuilder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiImportArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiImportArgsBuilder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiLicenseArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiLicenseArgsBuilder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiOauth2AuthorizationArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiOauth2AuthorizationArgsBuilder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiOpenidAuthenticationArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiOpenidAuthenticationArgsBuilder
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiSubscriptionKeyParameterNamesArgs
import com.pulumi.azure.apimanagement.kotlin.inputs.ApiSubscriptionKeyParameterNamesArgsBuilder
import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import kotlin.Boolean
import kotlin.Deprecated
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
import kotlin.jvm.JvmName
/**
* Manages an API within an API Management Service.
* ## Example Usage
*
* ```typescript
* 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: "My Company",
* publisherEmail: "[email protected]",
* skuName: "Developer_1",
* });
* const exampleApi = new azure.apimanagement.Api("example", {
* name: "example-api",
* resourceGroupName: example.name,
* apiManagementName: exampleService.name,
* revision: "1",
* displayName: "Example API",
* path: "example",
* protocols: ["https"],
* "import": {
* contentFormat: "swagger-link-json",
* contentValue: "http://conferenceapi.azurewebsites.net/?format=json",
* },
* });
* ```
* ```python
* 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="My Company",
* publisher_email="[email protected]",
* sku_name="Developer_1")
* example_api = azure.apimanagement.Api("example",
* name="example-api",
* resource_group_name=example.name,
* api_management_name=example_service.name,
* revision="1",
* display_name="Example API",
* path="example",
* protocols=["https"],
* import_={
* "content_format": "swagger-link-json",
* "content_value": "http://conferenceapi.azurewebsites.net/?format=json",
* })
* ```
* ```csharp
* 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 = "My Company",
* PublisherEmail = "[email protected]",
* SkuName = "Developer_1",
* });
* var exampleApi = new Azure.ApiManagement.Api("example", new()
* {
* Name = "example-api",
* ResourceGroupName = example.Name,
* ApiManagementName = exampleService.Name,
* Revision = "1",
* DisplayName = "Example API",
* Path = "example",
* Protocols = new[]
* {
* "https",
* },
* Import = new Azure.ApiManagement.Inputs.ApiImportArgs
* {
* ContentFormat = "swagger-link-json",
* ContentValue = "http://conferenceapi.azurewebsites.net/?format=json",
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-azure/sdk/v5/go/azure/apimanagement"
* "github.com/pulumi/pulumi-azure/sdk/v5/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("My Company"),
* PublisherEmail: pulumi.String("[email protected]"),
* SkuName: pulumi.String("Developer_1"),
* })
* if err != nil {
* return err
* }
* _, err = apimanagement.NewApi(ctx, "example", &apimanagement.ApiArgs{
* Name: pulumi.String("example-api"),
* ResourceGroupName: example.Name,
* ApiManagementName: exampleService.Name,
* Revision: pulumi.String("1"),
* DisplayName: pulumi.String("Example API"),
* Path: pulumi.String("example"),
* Protocols: pulumi.StringArray{
* pulumi.String("https"),
* },
* Import: &apimanagement.ApiImportArgs{
* ContentFormat: pulumi.String("swagger-link-json"),
* ContentValue: pulumi.String("http://conferenceapi.azurewebsites.net/?format=json"),
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* 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.Api;
* import com.pulumi.azure.apimanagement.ApiArgs;
* import com.pulumi.azure.apimanagement.inputs.ApiImportArgs;
* 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("My Company")
* .publisherEmail("[email protected]")
* .skuName("Developer_1")
* .build());
* var exampleApi = new Api("exampleApi", ApiArgs.builder()
* .name("example-api")
* .resourceGroupName(example.name())
* .apiManagementName(exampleService.name())
* .revision("1")
* .displayName("Example API")
* .path("example")
* .protocols("https")
* .import_(ApiImportArgs.builder()
* .contentFormat("swagger-link-json")
* .contentValue("http://conferenceapi.azurewebsites.net/?format=json")
* .build())
* .build());
* }
* }
* ```
* ```yaml
* 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: My Company
* publisherEmail: [email protected]
* skuName: Developer_1
* exampleApi:
* type: azure:apimanagement:Api
* name: example
* properties:
* name: example-api
* resourceGroupName: ${example.name}
* apiManagementName: ${exampleService.name}
* revision: '1'
* displayName: Example API
* path: example
* protocols:
* - https
* import:
* contentFormat: swagger-link-json
* contentValue: http://conferenceapi.azurewebsites.net/?format=json
* ```
*
* ## Import
* API Management API's can be imported using the `resource id`, e.g.
* ```sh
* $ pulumi import azure:apimanagement/api:Api example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.ApiManagement/service/instance1/apis/api1;rev=1
* ```
* @property apiManagementName The Name of the API Management Service where this API should be created. Changing this forces a new resource to be created.
* @property apiType Type of API. Possible values are `graphql`, `http`, `soap`, and `websocket`. Defaults to `http`.
* @property contact A `contact` block as documented below.
* @property description A description of the API Management API, which may include HTML formatting tags.
* @property displayName The display name of the API.
* @property import A `import` block as documented below.
* @property license A `license` block as documented below.
* @property name The name of the API Management API. Changing this forces a new resource to be created.
* @property oauth2Authorization An `oauth2_authorization` block as documented below.
* @property openidAuthentication An `openid_authentication` block as documented below.
* @property path The Path for this API Management API, which is a relative URL which uniquely identifies this API and all of its resource paths within the API Management Service.
* @property protocols A list of protocols the operations in this API can be invoked. Possible values are `http`, `https`, `ws`, and `wss`.
* > **NOTE:** `display_name`, `path` and `protocols` are required when `source_api_id` is not set.
* @property resourceGroupName The Name of the Resource Group where the API Management API exists. Changing this forces a new resource to be created.
* @property revision The Revision which used for this API. Changing this forces a new resource to be created.
* @property revisionDescription The description of the API Revision of the API Management API.
* @property serviceUrl Absolute URL of the backend service implementing this API.
* @property soapPassThrough Should this API expose a SOAP frontend, rather than a HTTP frontend? Defaults to `false`.
* > **NOTE:** This property has been deprecated in favour of the `api_type` property and will be removed in version 4.0 of the provider.
* @property sourceApiId The API id of the source API, which could be in format `azurerm_api_management_api.example.id` or in format `azurerm_api_management_api.example.id;rev=1`
* @property subscriptionKeyParameterNames A `subscription_key_parameter_names` block as documented below.
* @property subscriptionRequired Should this API require a subscription key? Defaults to `true`.
* @property termsOfServiceUrl Absolute URL of the Terms of Service for the API.
* @property version The Version number of this API, if this API is versioned.
* @property versionDescription The description of the API Version of the API Management API.
* @property versionSetId The ID of the Version Set which this API is associated with.
* > **NOTE:** When `version` is set, `version_set_id` must also be specified
*/
public data class ApiArgs(
public val apiManagementName: Output? = null,
public val apiType: Output? = null,
public val contact: Output? = null,
public val description: Output? = null,
public val displayName: Output? = null,
public val `import`: Output? = null,
public val license: Output? = null,
public val name: Output? = null,
public val oauth2Authorization: Output? = null,
public val openidAuthentication: Output? = null,
public val path: Output? = null,
public val protocols: Output>? = null,
public val resourceGroupName: Output? = null,
public val revision: Output? = null,
public val revisionDescription: Output? = null,
public val serviceUrl: Output? = null,
@Deprecated(
message = """
`soap_pass_through` will be removed in favour of the property `api_type` in version 4.0 of the
AzureRM Provider
""",
)
public val soapPassThrough: Output? = null,
public val sourceApiId: Output? = null,
public val subscriptionKeyParameterNames: Output? = null,
public val subscriptionRequired: Output? = null,
public val termsOfServiceUrl: Output? = null,
public val version: Output? = null,
public val versionDescription: Output? = null,
public val versionSetId: Output? = null,
) : ConvertibleToJava {
override fun toJava(): com.pulumi.azure.apimanagement.ApiArgs =
com.pulumi.azure.apimanagement.ApiArgs.builder()
.apiManagementName(apiManagementName?.applyValue({ args0 -> args0 }))
.apiType(apiType?.applyValue({ args0 -> args0 }))
.contact(contact?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
.description(description?.applyValue({ args0 -> args0 }))
.displayName(displayName?.applyValue({ args0 -> args0 }))
.import_(`import`?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
.license(license?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
.name(name?.applyValue({ args0 -> args0 }))
.oauth2Authorization(
oauth2Authorization?.applyValue({ args0 ->
args0.let({ args0 ->
args0.toJava()
})
}),
)
.openidAuthentication(
openidAuthentication?.applyValue({ args0 ->
args0.let({ args0 ->
args0.toJava()
})
}),
)
.path(path?.applyValue({ args0 -> args0 }))
.protocols(protocols?.applyValue({ args0 -> args0.map({ args0 -> args0 }) }))
.resourceGroupName(resourceGroupName?.applyValue({ args0 -> args0 }))
.revision(revision?.applyValue({ args0 -> args0 }))
.revisionDescription(revisionDescription?.applyValue({ args0 -> args0 }))
.serviceUrl(serviceUrl?.applyValue({ args0 -> args0 }))
.soapPassThrough(soapPassThrough?.applyValue({ args0 -> args0 }))
.sourceApiId(sourceApiId?.applyValue({ args0 -> args0 }))
.subscriptionKeyParameterNames(
subscriptionKeyParameterNames?.applyValue({ args0 ->
args0.let({ args0 -> args0.toJava() })
}),
)
.subscriptionRequired(subscriptionRequired?.applyValue({ args0 -> args0 }))
.termsOfServiceUrl(termsOfServiceUrl?.applyValue({ args0 -> args0 }))
.version(version?.applyValue({ args0 -> args0 }))
.versionDescription(versionDescription?.applyValue({ args0 -> args0 }))
.versionSetId(versionSetId?.applyValue({ args0 -> args0 })).build()
}
/**
* Builder for [ApiArgs].
*/
@PulumiTagMarker
public class ApiArgsBuilder internal constructor() {
private var apiManagementName: Output? = null
private var apiType: Output? = null
private var contact: Output? = null
private var description: Output? = null
private var displayName: Output? = null
private var `import`: Output? = null
private var license: Output? = null
private var name: Output? = null
private var oauth2Authorization: Output? = null
private var openidAuthentication: Output? = null
private var path: Output? = null
private var protocols: Output>? = null
private var resourceGroupName: Output? = null
private var revision: Output? = null
private var revisionDescription: Output? = null
private var serviceUrl: Output? = null
private var soapPassThrough: Output? = null
private var sourceApiId: Output? = null
private var subscriptionKeyParameterNames: Output? = null
private var subscriptionRequired: Output? = null
private var termsOfServiceUrl: Output? = null
private var version: Output? = null
private var versionDescription: Output? = null
private var versionSetId: Output? = null
/**
* @param value The Name of the API Management Service where this API should be created. Changing this forces a new resource to be created.
*/
@JvmName("rsjukdmpkcdudokh")
public suspend fun apiManagementName(`value`: Output) {
this.apiManagementName = value
}
/**
* @param value Type of API. Possible values are `graphql`, `http`, `soap`, and `websocket`. Defaults to `http`.
*/
@JvmName("urqgkqxdfjbrpfbp")
public suspend fun apiType(`value`: Output) {
this.apiType = value
}
/**
* @param value A `contact` block as documented below.
*/
@JvmName("beqcsnbwypddqyxk")
public suspend fun contact(`value`: Output) {
this.contact = value
}
/**
* @param value A description of the API Management API, which may include HTML formatting tags.
*/
@JvmName("efjrhufluqqegwdx")
public suspend fun description(`value`: Output) {
this.description = value
}
/**
* @param value The display name of the API.
*/
@JvmName("cbsnixpgephcjnqw")
public suspend fun displayName(`value`: Output) {
this.displayName = value
}
/**
* @param value A `import` block as documented below.
*/
@JvmName("vovufdxvtfvkhjkk")
public suspend fun `import`(`value`: Output) {
this.`import` = value
}
/**
* @param value A `license` block as documented below.
*/
@JvmName("arkahxeyuibvgsbv")
public suspend fun license(`value`: Output) {
this.license = value
}
/**
* @param value The name of the API Management API. Changing this forces a new resource to be created.
*/
@JvmName("cuxyfsefdrnescku")
public suspend fun name(`value`: Output) {
this.name = value
}
/**
* @param value An `oauth2_authorization` block as documented below.
*/
@JvmName("mkojclvsesudkqfw")
public suspend fun oauth2Authorization(`value`: Output) {
this.oauth2Authorization = value
}
/**
* @param value An `openid_authentication` block as documented below.
*/
@JvmName("rbvtxvrkqjhthrgh")
public suspend fun openidAuthentication(`value`: Output) {
this.openidAuthentication = value
}
/**
* @param value The Path for this API Management API, which is a relative URL which uniquely identifies this API and all of its resource paths within the API Management Service.
*/
@JvmName("lyxxquvnaqitmlbi")
public suspend fun path(`value`: Output) {
this.path = value
}
/**
* @param value A list of protocols the operations in this API can be invoked. Possible values are `http`, `https`, `ws`, and `wss`.
* > **NOTE:** `display_name`, `path` and `protocols` are required when `source_api_id` is not set.
*/
@JvmName("difgvcwdcmglgedo")
public suspend fun protocols(`value`: Output>) {
this.protocols = value
}
@JvmName("eusypwcllljcilhu")
public suspend fun protocols(vararg values: Output) {
this.protocols = Output.all(values.asList())
}
/**
* @param values A list of protocols the operations in this API can be invoked. Possible values are `http`, `https`, `ws`, and `wss`.
* > **NOTE:** `display_name`, `path` and `protocols` are required when `source_api_id` is not set.
*/
@JvmName("csdmauwbvbedacab")
public suspend fun protocols(values: List