azure-native.azuresphere.Image
Explore with Pulumi AI
An image resource belonging to a catalog resource.
Uses Azure REST API version 2024-04-01. In version 2.x of the Azure Native provider, it used API version 2022-09-01-preview.
Other available API versions: 2022-09-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native azuresphere [ApiVersion]
. See the version guide for details.
Create Image Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Image(name: string, args: ImageArgs, opts?: CustomResourceOptions);
@overload
def Image(resource_name: str,
args: ImageInitArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Image(resource_name: str,
opts: Optional[ResourceOptions] = None,
catalog_name: Optional[str] = None,
resource_group_name: Optional[str] = None,
image: Optional[str] = None,
image_id: Optional[str] = None,
image_name: Optional[str] = None,
regional_data_boundary: Optional[Union[str, RegionalDataBoundary]] = None)
func NewImage(ctx *Context, name string, args ImageArgs, opts ...ResourceOption) (*Image, error)
public Image(string name, ImageArgs args, CustomResourceOptions? opts = null)
type: azure-native:azuresphere:Image
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name
This property is required. string - The unique name of the resource.
- args
This property is required. ImageArgs - The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name
This property is required. str - The unique name of the resource.
- args
This property is required. ImageInitArgs - The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name
This property is required. string - The unique name of the resource.
- args
This property is required. ImageArgs - The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name
This property is required. string - The unique name of the resource.
- args
This property is required. ImageArgs - The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name
This property is required. String - The unique name of the resource.
- args
This property is required. ImageArgs - The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var imageResource = new AzureNative.AzureSphere.Image("imageResource", new()
{
CatalogName = "string",
ResourceGroupName = "string",
Image = "string",
ImageId = "string",
ImageName = "string",
RegionalDataBoundary = "string",
});
example, err := azuresphere.NewImage(ctx, "imageResource", &azuresphere.ImageArgs{
CatalogName: pulumi.String("string"),
ResourceGroupName: pulumi.String("string"),
Image: pulumi.String("string"),
ImageId: pulumi.String("string"),
ImageName: pulumi.String("string"),
RegionalDataBoundary: pulumi.String("string"),
})
var imageResource = new Image("imageResource", ImageArgs.builder()
.catalogName("string")
.resourceGroupName("string")
.image("string")
.imageId("string")
.imageName("string")
.regionalDataBoundary("string")
.build());
image_resource = azure_native.azuresphere.Image("imageResource",
catalog_name="string",
resource_group_name="string",
image="string",
image_id="string",
image_name="string",
regional_data_boundary="string")
const imageResource = new azure_native.azuresphere.Image("imageResource", {
catalogName: "string",
resourceGroupName: "string",
image: "string",
imageId: "string",
imageName: "string",
regionalDataBoundary: "string",
});
type: azure-native:azuresphere:Image
properties:
catalogName: string
image: string
imageId: string
imageName: string
regionalDataBoundary: string
resourceGroupName: string
Image Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Image resource accepts the following input properties:
- Catalog
Name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- Resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- Image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- Image
Id Changes to this property will trigger replacement.
- Image ID
- Image
Name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- Regional
Data Boundary Changes to this property will trigger replacement.
Azure Native. Azure Sphere. Regional Data Boundary - Regional data boundary for an image
- Catalog
Name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- Resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- Image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- Image
Id Changes to this property will trigger replacement.
- Image ID
- Image
Name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- Regional
Data Boundary Changes to this property will trigger replacement.
Data Boundary - Regional data boundary for an image
- catalog
Name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- image
Id Changes to this property will trigger replacement.
- Image ID
- image
Name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- regional
Data Boundary Changes to this property will trigger replacement.
Data Boundary - Regional data boundary for an image
- catalog
Name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- image
Id Changes to this property will trigger replacement.
- Image ID
- image
Name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- regional
Data Boundary Changes to this property will trigger replacement.
Data Boundary - Regional data boundary for an image
- catalog_
name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- resource_
group_ name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- image_
id Changes to this property will trigger replacement.
- Image ID
- image_
name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- regional_
data_ boundary Changes to this property will trigger replacement.
Data Boundary - Regional data boundary for an image
- catalog
Name This property is required. Changes to this property will trigger replacement.
- Name of catalog
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- image
Changes to this property will trigger replacement.
- Image as a UTF-8 encoded base 64 string on image create. This field contains the image URI on image reads.
- image
Id Changes to this property will trigger replacement.
- Image ID
- image
Name Changes to this property will trigger replacement.
- Image name. Use an image GUID for GA versions of the API.
- regional
Data Boundary Changes to this property will trigger replacement.
- Regional data boundary for an image
Outputs
All input properties are implicitly available as output properties. Additionally, the Image resource produces the following output properties:
- Azure
Api stringVersion - The Azure API version of the resource.
- Component
Id string - The image component id.
- Description string
- The image description.
- Id string
- The provider-assigned unique ID for this managed resource.
- Image
Type string - The image type.
- Name string
- The name of the resource
- Provisioning
State string - The status of the last operation.
- System
Data Pulumi.Azure Native. Azure Sphere. Outputs. System Data Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Uri string
- Location the image
- Azure
Api stringVersion - The Azure API version of the resource.
- Component
Id string - The image component id.
- Description string
- The image description.
- Id string
- The provider-assigned unique ID for this managed resource.
- Image
Type string - The image type.
- Name string
- The name of the resource
- Provisioning
State string - The status of the last operation.
- System
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Uri string
- Location the image
- azure
Api StringVersion - The Azure API version of the resource.
- component
Id String - The image component id.
- description String
- The image description.
- id String
- The provider-assigned unique ID for this managed resource.
- image
Type String - The image type.
- name String
- The name of the resource
- provisioning
State String - The status of the last operation.
- system
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- uri String
- Location the image
- azure
Api stringVersion - The Azure API version of the resource.
- component
Id string - The image component id.
- description string
- The image description.
- id string
- The provider-assigned unique ID for this managed resource.
- image
Type string - The image type.
- name string
- The name of the resource
- provisioning
State string - The status of the last operation.
- system
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- uri string
- Location the image
- azure_
api_ strversion - The Azure API version of the resource.
- component_
id str - The image component id.
- description str
- The image description.
- id str
- The provider-assigned unique ID for this managed resource.
- image_
type str - The image type.
- name str
- The name of the resource
- provisioning_
state str - The status of the last operation.
- system_
data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type str
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- uri str
- Location the image
- azure
Api StringVersion - The Azure API version of the resource.
- component
Id String - The image component id.
- description String
- The image description.
- id String
- The provider-assigned unique ID for this managed resource.
- image
Type String - The image type.
- name String
- The name of the resource
- provisioning
State String - The status of the last operation.
- system
Data Property Map - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- uri String
- Location the image
Supporting Types
RegionalDataBoundary, RegionalDataBoundaryArgs
- None
- NoneNo data boundary
- EU
- EUEU data boundary
- Regional
Data Boundary None - NoneNo data boundary
- Regional
Data Boundary EU - EUEU data boundary
- None
- NoneNo data boundary
- EU
- EUEU data boundary
- None
- NoneNo data boundary
- EU
- EUEU data boundary
- NONE
- NoneNo data boundary
- EU
- EUEU data boundary
- "None"
- NoneNo data boundary
- "EU"
- EUEU data boundary
SystemDataResponse, SystemDataResponseArgs
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The timestamp of resource last modification (UTC)
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The timestamp of resource last modification (UTC)
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The timestamp of resource last modification (UTC)
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified StringBy Type - The type of identity that last modified the resource.
- created
At string - The timestamp of resource creation (UTC).
- created
By string - The identity that created the resource.
- created
By stringType - The type of identity that created the resource.
- last
Modified stringAt - The timestamp of resource last modification (UTC)
- last
Modified stringBy - The identity that last modified the resource.
- last
Modified stringBy Type - The type of identity that last modified the resource.
- created_
at str - The timestamp of resource creation (UTC).
- created_
by str - The identity that created the resource.
- created_
by_ strtype - The type of identity that created the resource.
- last_
modified_ strat - The timestamp of resource last modification (UTC)
- last_
modified_ strby - The identity that last modified the resource.
- last_
modified_ strby_ type - The type of identity that last modified the resource.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The timestamp of resource last modification (UTC)
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified StringBy Type - The type of identity that last modified the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:azuresphere:Image MyProduct1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/images/{imageName}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0