---
title: Images
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/terraform)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Images

#### ImagesV1

#### data cloudflare\_image

##### required Expand Collapse

account\_id: String

Account identifier tag.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>)

image\_id: String

Image unique identifier.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20image_id>)

##### computed Expand Collapse

creator: String

Can set the creator field with an internal user ID.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20creator>)

filename: String

Image file name.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20filename>)

id: String

Image unique identifier.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>)

require\_signed\_urls: Bool

Indicates whether the image can be a accessed only using it’s UID. If set to true, a signed token needs to be generated with a signing key to view the image.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20require_signed_urls>)

uploaded: Time

When the media item was uploaded.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20uploaded>)

variants: List\[String]

Object specifying available variants for an image.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variants>)

meta: JSON

User modifiable key-value store. Can be used for keeping references to another system of record for managing images. Metadata must not exceed 1024 bytes.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20meta>)

### cloudflare\_image

Terraform

HTTPTypeScriptPythonGoTerraform

```
data "cloudflare_image" "example_image" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  image_id = "image_id"
}
```

#### data cloudflare\_images

##### required Expand Collapse

account\_id: String

Account identifier tag.

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20account_id>)

##### optional Expand Collapse

creator?: String

Internal user ID set within the creator field. Setting to empty string "" will return images where creator field is not set

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20creator>)

max\_items?: Int64

Max items to fetch, default: 1000

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>)

##### computed Expand Collapse

<details>

<summary>

result: List\[Attributes]

The items returned by the data source

</summary>

<details>

<summary>

images: List\[Attributes]

</summary>

id: String

Image unique identifier.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20id">Link to this property</a>

creator: String

Can set the creator field with an internal user ID.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20creator">Link to this property</a>

filename: String

Image file name.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20filename">Link to this property</a>

meta: JSON

User modifiable key-value store. Can be used for keeping references to another system of record for managing images. Metadata must not exceed 1024 bytes.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20meta">Link to this property</a>

require\_signed\_urls: Bool

Indicates whether the image can be a accessed only using it’s UID. If set to true, a signed token needs to be generated with a signing key to view the image.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20require_signed_urls">Link to this property</a>

uploaded: Time

When the media item was uploaded.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20uploaded">Link to this property</a>

variants: List\[String]

Object specifying available variants for an image.

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images%20%3E%20(attribute)%20variants">Link to this property</a>

</details>

<a href="#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20images">Link to this property</a>

</details>

[Link to this property](<#(resource)%20images.v1%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>)

### cloudflare\_images

Terraform

HTTPTypeScriptPythonGoTerraform

```
data "cloudflare_images" "example_images" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  creator = "creator"
}
```

#### ImagesV1Variants

#### resource cloudflare\_image\_variant

##### required Expand Collapse

id: String

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>)

account\_id: String

Account identifier tag.

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20account_id>)

<details>

<summary>

options: Attributes

Allows you to define image resizing sizes for different use cases.

</summary>

fit: String

The fit property describes how the width and height dimensions should be interpreted.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20options%20%3E%20(attribute)%20fit">Link to this property</a>

height: Float64

Maximum height in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20options%20%3E%20(attribute)%20height">Link to this property</a>

metadata: String

What EXIF data should be preserved in the output image.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20options%20%3E%20(attribute)%20metadata">Link to this property</a>

width: Float64

Maximum width in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20options%20%3E%20(attribute)%20width">Link to this property</a>

</details>

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20options>)

##### optional Expand Collapse

never\_require\_signed\_urls?: Bool

Indicates whether the variant can access an image without a signature, regardless of image access control.

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20never_require_signed_urls>)

##### computed Expand Collapse

<details>

<summary>

variant: Attributes

</summary>

id: String

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20id">Link to this property</a>

<details>

<summary>

options: Attributes

Allows you to define image resizing sizes for different use cases.

</summary>

fit: String

The fit property describes how the width and height dimensions should be interpreted.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20fit">Link to this property</a>

height: Float64

Maximum height in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20height">Link to this property</a>

metadata: String

What EXIF data should be preserved in the output image.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20metadata">Link to this property</a>

width: Float64

Maximum width in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20width">Link to this property</a>

</details>

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options">Link to this property</a>

never\_require\_signed\_urls: Bool

Indicates whether the variant can access an image without a signature, regardless of image access control.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20never_require_signed_urls">Link to this property</a>

</details>

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20variant>)

### cloudflare\_image\_variant

Terraform

HTTPTypeScriptPythonGoTerraform

```
resource "cloudflare_image_variant" "example_image_variant" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  id = "hero"
  options = {
    fit = "scale-down"
    height = 768
    metadata = "none"
    width = 1366
  }
  never_require_signed_urls = true
}
```

#### data cloudflare\_image\_variant

##### required Expand Collapse

variant\_id: String

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant_id>)

account\_id: String

Account identifier tag.

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>)

##### computed Expand Collapse

id: String

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>)

<details>

<summary>

variant: Attributes

</summary>

id: String

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20id">Link to this property</a>

<details>

<summary>

options: Attributes

Allows you to define image resizing sizes for different use cases.

</summary>

fit: String

The fit property describes how the width and height dimensions should be interpreted.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20fit">Link to this property</a>

height: Float64

Maximum height in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20height">Link to this property</a>

metadata: String

What EXIF data should be preserved in the output image.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20metadata">Link to this property</a>

width: Float64

Maximum width in image pixels.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options%20%3E%20(attribute)%20width">Link to this property</a>

</details>

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20options">Link to this property</a>

never\_require\_signed\_urls: Bool

Indicates whether the variant can access an image without a signature, regardless of image access control.

<a href="#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant%20%3E%20(attribute)%20never_require_signed_urls">Link to this property</a>

</details>

[Link to this property](<#(resource)%20images.v1.variants%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20variant>)

### cloudflare\_image\_variant

Terraform

HTTPTypeScriptPythonGoTerraform

```
data "cloudflare_image_variant" "example_image_variant" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  variant_id = "hero"
}
```